기술 글은 이해에 필요한 맥락을 외부 읽기에 떠넘기지 않는다
대상 독자가 현재 글을 이해하는 데 필요한 용어와 전편의 맥락은 본문에서 설명한다. 링크는 그 설명을 대신하기보다 더 깊이 탐색할 길을 제공한다.
본문에 둘 설명의 범위
모든 배경지식을 담는다는 뜻은 아니다. 대상 독자가 이미 아는 것은 전제로 두되, 현재 논지를 잇는 데 빠진 설명을 보충한다. 연재도 관련 맥락을 요약해 시작할 수 있다.
이 판단은 설명을 읽는 흐름에 적용한다. 링크로 여러 주제를 탐색하도록 구성한 Map의 역할이나 원천을 직접 검증할 필요까지 없애지는 않는다. 이 적용 구분은 Codex의 종합이며, 모든 문서를 독립된 입문서로 바꾸는 지침은 아니다.
근거와 연결
- 개발 블로그의 독자와 읽기 흐름 - Michael Lynch: 2026-10-09 원문의 링크·전편 의존 조언과 대조.
- 기술 설명은 현상을 모델과 적용으로 연결한다: 독자가 아는 것과 새 설명을 잇는 방법.
- UI 디자인