과거에 작성한 기술 문서나 연구 논문에서 가장 어려웠던 점은 무엇이었고, 어떻게 해결했나요?

사내 문서만 작성해오다가 처음으로 외부에 공개되는 기술 블로그 글을 쓰게 됐어요. 내용은 잘 알고 있었는데, "외부 독자가 이 글을 읽고 무엇을 가져갈 것인가"를 고려해야 한다는 게 완전히 새로운 기준이었습니다.

사내 문서는 맥락을 공유한 독자에게 쓰지만, 외부 글은 맥락을 전혀 모르는 독자를 위해 써야 한다는 걸 그 경험에서 배웠어요. "당연히 알겠지"라고 넘어간 배경 설명이 외부 독자에게는 가장 필요한 부분이었고, 초안을 여러 번 고쳐야 했습니다.

그 경험 이후 문서를 쓸 때 "이 글을 처음 보는 사람이 읽으면 어느 부분에서 막히는가"를 항상 상상하면서 씁니다. 내가 이해하는 것과 독자가 이해하는 것 사이의 간극을 메우는 것이 기술 문서 작성의 핵심이라는 원칙이 그때 자리를 잡았어요.