Changelog entry는 “무엇이 바뀜”보다 “사용자가 뭘 해야 함”이 먼저였습니다

Product changelog를 사용자 행동으로 이어지게 쓰는 방식에 대한 메모.

작은 제품의 changelog를 보면 “fixed bugs”나 “improved performance”처럼 끝나는 경우가 많습니다. 하지만 사용자는 어느 화면, 어떤 API, 어떤 export, 어떤 결제 단계가 바뀌었는지 알고 싶어합니다. 저는 changelog entry에 old behavior, new behavior, affected area, required action을 넣는 편이 더 낫다고 봅니다. action이 없으면 “no action needed”라고 적는 것도 도움이 됩니다.