변경 기록은 프로젝트에서 달라진 중요한 내용을 날짜나 버전별로 정리해 이용자와 다음 담당자에게 전달하는 문서다. Keep a Changelog는 이 기록을 사람이 읽는 자료로 보고, 추가와 변경, 폐기 예정과 제거, 수정 등을 구분해 적도록 제안한다. 작업 중 생긴 모든 저장 이력을 그대로 나열하기보다 이용자가 알아야 할 차이를 골라 쓰는 것이 이 방식의 핵심이다.
- 작은 웹사이트라면 바뀐 기능과 날짜, 이용자가 할 일을 한곳에 적어보자.
- 메뉴를 옮겼다면 내부 작업 이름보다 새 위치를 알려주자. 이용자에게 쓰는 변경 안내의 예다.
- 실제 기록에는 확인된 변경 내용과 이유를 적자.
특히 없앨 기능은 실제 제거 기록과 폐기 예고를 구분해야 미리 다른 방법을 준비할 수 있다. 웹사이트 인수인계에 변경 기록을 붙여두면 담당자가 바뀌었을 때 결정의 순서와 현재 상태를 확인하기 쉬워진다. 기록의 길이가 유지 보수를 가로막지 않도록 사소한 내부 수정까지 매번 공지할 필요는 없지만, 이용 방식이 달라진 일은 빠뜨리지 않아야 한다. 아직 적용하지 않은 계획은 별도 구역에 두고, 실제로 바뀐 내용과 섞이지 않게 관리하자.