Keeping Your Modules Compatible
Guidance on evolving public Go APIs without unnecessary breaking module releases.
Guidance on evolving public Go APIs without unnecessary breaking module releases.
- Author: Go Team
- Authority: primary
- Kind: blog
- URL: https://go.dev/blog/module-compatibility
What it covers
- breaking vs non-breaking changes
- compatibility techniques
- API evolution strategy
Why authoritative
Official Go guidance on compatibility-preserving API evolution.
Use when
- is this a breaking Go module change
- how should I evolve this public Go API
- can I make this change without cutting v2
Keywords
- module compatibility, breaking changes, api evolution, public API, modules