<aside> 💡

Insight: 개발자는 본인이 고생한(노력을 많이 들인) 기능을 강조하고 싶어 하지만, 독자에게 중요한 것은 '나에게 무엇이 좋아졌는가'이다.

</aside>

Sementic Versioning

버전을 Major.Minor.Patch (예: v1.0.2)로 하고

  1. 기존 버전과 호환되지 않게 API가 바뀌면 “Major 버전”을 올리고,
  2. 기존 버전과 호환되면서 새로운 기능을 추가할 때는 “Minor 버전”을 올리고,
  3. 기존 버전과 호환되면서 버그를 수정한 것이라면 “Patch 버전”을 올린다.

Major.Minor.Patch 형식에 정식 배포 전 버전이나 빌드 메타데이터를 위한 라벨을 덧붙이는 방법도 있다.

문제 해결 관점에서의 서술

문제 유형 설명 예시
1. 발생형 문제 당장 눈앞에 닥친, 기준에 미달된 문제 프로그램 에러, 버그 수정
2. 탐색형 문제 당장 급하진 않지만 방치하면 손실이 되는 문제 리팩토링, 성능 개선, 효율화
3. 설정형 문제 미래 상황에 대응하기 위한 새로운 목표 신규 기능 추가, 아키텍처 변경

참고자료)

v1.0.0 (Jan 23, 2026)

v1.0.1 (Jan 27, 2026)

v2.0.0 (Jan 30, 2026)