경험 기반 구체화
문서화에서 제가 가장 중요하게 생각하는 건 실시간으로 기록하는 습관입니다. 나중에 기억을 되살려 쓰면 세부 사항이 빠지거나 뉘앙스가 달라지는 경우가 많습니다. 학교 실험 보고서를 쓸 때도, 실험 직후에 바로 노트에 기록해두면 보고서 완성 속도가 눈에 띄게 빨라졌습니다. 보고에서는 독자가 무엇을 판단해야 하는가를 먼저 생각합니다. 모든 내용을 나열하기보다, 의사결정에 필요한 핵심 정보를 먼저 제시하고 세부 사항은 첨부로 남기는 방식이 효과적이었습니다.
형식이 일관되어야 여러 문서를 비교하거나 히스토리를 추적할 때 쉬워집니다. 좋은 문서화는 나 혼자가 아니라 나 다음에 보는 사람을 위한 것이라는 기준으로 작성합니다. 미래의 나도 독자라는 생각으로, 지금 당연한 내용도 맥락을 남겨두는 습관이 생겼습니다.