변경 기록은 프로젝트에서 달라진 중요한 내용을 날짜나 버전별로 정리해 이용자와 다음 담당자에게 전달하는 문서다. Keep a Changelog는 이 기록을 사람이 읽는 자료로 보고, 추가와 변경, 폐기 예정과 제거, 수정 등을 구분해 적도록 제안한다. 작업 중 생긴 모든 저장 이력을 그대로 나열하기보다 이용자가 알아야 할 차이를 골라 쓰는 것이 이 방식의 핵심이다.

- 작은 [[웹사이트]]라면 바뀐 기능과 날짜, 이용자가 할 일을 한곳에 적어보자.
- 메뉴를 옮겼다면 내부 작업 이름보다 새 위치를 알려주자. [[이용자에게 쓰는 변경 안내]]의 예다.
- 실제 기록에는 [[변경 기록에 남길 근거|확인된 변경 내용과 이유]]를 적자.

특히 없앨 기능은 실제 제거 기록과 [[기능 폐기 예고|폐기 예고]]를 구분해야 미리 다른 방법을 준비할 수 있다. [[웹사이트 인수인계]]에 변경 기록을 붙여두면 담당자가 바뀌었을 때 결정의 순서와 현재 상태를 확인하기 쉬워진다. 기록의 길이가 [[유지 보수]]를 가로막지 않도록 사소한 내부 수정까지 매번 공지할 필요는 없지만, 이용 방식이 달라진 일은 빠뜨리지 않아야 한다. 아직 적용하지 않은 계획은 별도 구역에 두고, 실제로 바뀐 내용과 섞이지 않게 관리하자.

## 참고

- [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)

#웹 #유지보수 #기록