Semantic Versioning
セマンティックバージョニング
セマンティックバージョニング(SemVer)は、公開APIの変更点を示すためにMAJOR.MINOR.PATCH番号を使用します。また、プレリリースおよびビルドラベルのルールも定めます。
もう一つの例
ライブラリは2.4.1にあり、古いコードでも動作するAPIを追加します。メンテナは2.5.0をリリースし、その追加を記録します。公開されたAPIが明記されていなければ、これらのバージョン番号は互換性を明確に約束することはできません。
主な部分
- 01公開 API
- 02互換性の変更
- 03バージョン識別子
以下の場合に使用します
公開APIが宣言されており、リリース番号が互換性の変更を示すソフトウェアにこの用語を使用します。
以下の場合は使用しないでください
SemVer番号だけで製品の品質、リリース日、アップグレード作業を推測してはいけない。
コードで使用する名前
MAJOR.MINOR.PATCH[-prerelease][+build] 出荷前に
Check the runtime and version, integration limits, dependencies and licenses, and platform support. Verify security, failure, speed, monitoring, deploy, support owner, upgrade path, and rollback.
Outcome:Complete the task with セマンティックバージョニング (Semantic Versioning)。 User context:ライブラリは2.4.1にあり、古いコードでも動作するAPIを追加します。メンテナは2.5.0をリリースし、その追加を記録します。公開されたAPIが明記されていなければ、これらのバージョン番号は互換性を明確に約束することはできません。 Technology or engineering concept:セマンティックバージョニング (Semantic Versioning)。 Why it fits:公開APIが宣言されており、リリース番号が互換性の変更を示すソフトウェアにこの用語を使用します。 Do not use it when:SemVer番号だけで製品の品質、リリース日、アップグレード作業を推測してはいけない。 Engineering fit: Define where it runs and which version to use. Set its job, interfaces, data flow, dependencies, supported systems, security, and speed limits. Explain how it fits the current stack. Lifecycle safeguards: Check dependency health and licenses. Add monitoring and a fallback. Name the upgrade owner. Do not add a second tool for the same job without a measured benefit. Acceptance criteria: A small integration proves the needed behavior. Test compatibility, security, failure, and performance. Document deploy, upgrade, support, and rollback steps. Evidence and limits (evidence boundary):きちんとした書類でも、まだドラフトやリリース候補、あるいは最終版かもしれません。ステータスや、ブラウザやプラットフォームの対応状況を確認しましょう。 Unknowns to confirm: Current stack, runtime and version rules, target systems, dependency owner, performance budget, support period, and migration limits.
このリクエストを確認する
Review how セマンティックバージョニング (Semantic Versioning) is used now. Definition: セマンティックバージョニング(SemVer)は、公開APIの変更点を示すためにMAJOR.MINOR.PATCH番号を使用します。また、プレリリースおよびビルドラベルのルールも定めます。 Release checks: Check the runtime and version, integration limits, dependencies and licenses, and platform support. Verify security, failure, speed, monitoring, deploy, support owner, upgrade path, and rollback. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.