Changelog에 넣을 일과 docs에 넣을 일을 구분하는 기준

사용자 의도 기준으로 changelog, docs, troubleshooting, incident note를 분리하는 메모.

Changelog는 “무엇이 바뀌었나”를 찾는 사람에게 맞고, docs는 “어떻게 하나”를 찾는 사람에게 맞습니다. 제품은 그대로인데 설명이 부족했다면 changelog가 아니라 docs update가 맞고, 특정 증상이 반복된다면 troubleshooting note가 더 낫습니다. 일시 장애나 신뢰 이슈라면 incident/known issue 쪽으로 분리해야 하고요. 작은 팀일수록 한 사람이 다 쓰다 보니 이 경계가 흐려지는데, 검색되는 기록으로 남기려면 제목부터 user intent에 맞추는 게 좋아 보입니다.