Versioning

8 items tagged with "versioning"

Filter by type:

Standards1

SemVer 2.0.0

Semantic Versioning (SemVer) is essential for software migrations, providing a clear framework for versioning that helps teams manage changes effectively. By understanding SemVer's principles and implementing robust compliance strategies, teams can mitigate risks, improve dependency management, and facilitate clear communication throughout the migration process.

Best Practices3

Best Practice

Microsoft REST API Guidelines

Cross-company REST consistency rules (nouns, verbs, versioning, errors).

Best Practice

Semantic Versioning 2.0.0

Consistent MAJOR.MINOR.PATCH versioning rules for APIs and packages.

Best Practice

API Backward Compatibility

Evolving an API without breaking existing clients by making only additive changes, versioning breaking changes, and deprecating fields gracefully over time.

Patterns1

Pattern

API Versioning

Strategies for evolving an API without breaking existing clients, by exposing multiple versions through URLs, headers, or media types.

Anti-Patterns1

Anti-Pattern

Breaking Changes Without Versioning

Changing an API's contract in place without versioning or deprecation, silently breaking existing clients and eroding trust.

Tutorials1

Tutorial

How to automate versioning and releases with semantic-release

Use semantic-release and Conventional Commits to automatically determine versions, tag releases, and publish from CI.

Checklists1

Checklist

API Modernisation Checklist

Checklist for modernizing and versioning APIs