The ORAS Go library follows Semantic Versioning, where breaking changes are reserved for MAJOR releases, and MINOR and PATCH releases must be 100% backwards compatible.
As there are various stable projects depending on the ORAS Go library, the
v1
branch
is maintained for API stability, dependency updates, and security patches.
All v1.*
releases are based upon this branch.
If you are seeking stability over new features, you are highly encouraged
to use releases with major version 1
.
In contrast to the v1
branch, the
main
branch
is where all new feature development will occur.
Any backward-incompatible changes will follow our versioning policy and be reserved for the next major version of the library (2
), which users may opt into.
Examples for common use cases can be found below:
If you are seeking new features over stability, you should use the
main
branch (or a specific commit hash) when including the ORAS
Go library in your project's go.mod
.
The Go Reference for the main
branch is available here.
To migrate from v1
to v2
, see MIGRATION_GUIDE.md.
- oras.land/client_libraries/go: Documentation for the ORAS Go library
- Reviewing guide: All reviewers must read the reviewing guide and agree to follow the project review guidelines.
This project has adopted the CNCF Code of Conduct. See CODE_OF_CONDUCT.md for further details.