SemVer 편집하기 (부분)

== 개요 ==
'''유의적 버전''' 또는 '''시맨틱 버전'''({{llang|en|Semantic Versioning}}, '''SemVer''')은 [[소프트웨어]]의 [[버전]] 번호에 일정한 의미를 부여하여, 배포판 사이의 변경 범위와 [[하위 호환성]] 여부를 표현하는 버전 표기 규칙이다.<ref name="semver-ko">[https://semver.org/lang/ko/ 유의적 버전 2.0.0], Semantic Versioning 공식 한국어 문서.</ref>

기본 형식은 '''MAJOR.MINOR.PATCH'''이며, 한국어 공식 문서에서는 이를 각각 '''주 버전''', '''부 버전''', '''수 버전'''으로 번역한다.<ref name="semver-ko" /> 예를 들어 '''2.4.1'''이라는 버전은 주 버전이 2, 부 버전이 4, 수 버전이 1이라는 뜻이다.

유의적 버전의 목적은 단순히 버전을 보기 좋게 표시하는 것이 아니라, 버전 번호만으로도 어느 정도의 [[API]] 변경이 있었는지 알 수 있게 하는 데 있다. 일반적으로 주 버전이 바뀌면 기존 코드와 호환되지 않는 변경이 있었을 가능성이 높고, 부 버전이 바뀌면 기존 코드와 호환되는 기능 추가가 있었음을 뜻하며, 수 버전이 바뀌면 기존 코드와 호환되는 [[버그]] 수정이 있었음을 뜻한다.

다만 유의적 버전이 의미를 가지려면 해당 소프트웨어가 먼저 명확한 '''공개 API'''를 선언해야 한다.<ref name="semver-en">[https://semver.org/ Semantic Versioning 2.0.0], Semantic Versioning 공식 문서.</ref> 여기서 공개 API는 외부 사용자가 의존할 수 있는 함수, 클래스, 명령어, 설정 형식, 데이터 형식, 프로토콜, 문서화된 동작 등을 포함할 수 있다. 공개 API가 명확하지 않으면 어떤 변경이 호환성을 깨뜨리는 변경인지 판단하기 어렵다.