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.