Semantic Versioning
Versionamento Semântico
Versionamento Semântico (SemVer) usa números MAJOR.MINOR.PATCH para mostrar como uma API pública mudou. Também define regras para rótulos de pré-lançamento e de build.
Outro exemplo
Uma biblioteca está na versão 2.4.1 e adiciona uma API que ainda funciona com código antigo. O mantenedor lança a versão 2.5.0 e registra a adição. Sem uma API pública declarada, esses números não podem prometer claramente compatibilidade.
Partes principais
- 01API pública
- 02mudança de compatibilidade
- 03identificador de versão
Use-o quando
Use este termo para software com uma API pública declarada cujos números de versão mostram mudanças de compatibilidade.
Não o use quando
Não adivinhe a qualidade do produto, data de lançamento ou trabalho de atualização apenas a partir de um número SemVer.
Nome usado no código
MAJOR.MINOR.PATCH[-prerelease][+build] Antes de lançar
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 Versionamento Semântico (Semantic Versioning). User context: Uma biblioteca está na versão 2.4.1 e adiciona uma API que ainda funciona com código antigo. O mantenedor lança a versão 2.5.0 e registra a adição. Sem uma API pública declarada, esses números não podem prometer claramente compatibilidade. Technology or engineering concept: Versionamento Semântico (Semantic Versioning). Why it fits: Use este termo para software com uma API pública declarada cujos números de versão mostram mudanças de compatibilidade. Do not use it when: Não adivinhe a qualidade do produto, data de lançamento ou trabalho de atualização apenas a partir de um número 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): Um documento formal ainda pode ser rascunho, release candidate ou versão final. Cheque o status e o suporte no navegador ou plataforma. Unknowns to confirm: Current stack, runtime and version rules, target systems, dependency owner, performance budget, support period, and migration limits.
Conferir este pedido
Review how Versionamento Semântico (Semantic Versioning) is used now. Definition: Versionamento Semântico (SemVer) usa números MAJOR.MINOR.PATCH para mostrar como uma API pública mudou. Também define regras para rótulos de pré-lançamento e de build. 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.