Semantic Versioning
versionado semántico
El versionado semántico (SemVer) utiliza números MAYOR.MENOR.PARCHE para mostrar cómo cambió una API pública. También establece reglas para etiquetas de pre-lanzamiento y de construcción.
Otro ejemplo
Una biblioteca está en la versión 2.4.1 y agrega una API que todavía funciona con código antiguo. El mantenedor lanza la versión 2.5.0 y registra la adición. Sin una API pública declarada, estos números no pueden prometer claramente compatibilidad.
Partes principales
- 01API pública
- 02cambio de compatibilidad
- 03identificador de versión
Úsalo cuando
Use este término para software con una API pública declarada cuyos números de versión muestran cambios de compatibilidad.
No lo uses cuando
No adivines la calidad del producto, la fecha de lanzamiento o el trabajo de actualización solo a partir de un número SemVer.
Nombre usado en código
MAJOR.MINOR.PATCH[-prerelease][+build] Antes de lanzarlo
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 versionado semántico (Semantic Versioning). User context: Una biblioteca está en la versión 2.4.1 y agrega una API que todavía funciona con código antiguo. El mantenedor lanza la versión 2.5.0 y registra la adición. Sin una API pública declarada, estos números no pueden prometer claramente compatibilidad. Technology or engineering concept: versionado semántico (Semantic Versioning). Why it fits: Use este término para software con una API pública declarada cuyos números de versión muestran cambios de compatibilidad. Do not use it when: No adivines la calidad del producto, la fecha de lanzamiento o el trabajo de actualización solo a partir de un 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): Un documento formal aún puede ser un borrador, un release candidate o una versión final. Revisa su estado y la compatibilidad con tu navegador o plataforma. Unknowns to confirm: Current stack, runtime and version rules, target systems, dependency owner, performance budget, support period, and migration limits.
Revisa esta petición
Review how versionado semántico (Semantic Versioning) is used now. Definition: El versionado semántico (SemVer) utiliza números MAYOR.MENOR.PARCHE para mostrar cómo cambió una API pública. También establece reglas para etiquetas de pre-lanzamiento y de construcción. 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.