설명 자료는 관찰 질문과 해석을 함께 제공한다

설명용 그림·차트·데모에는 독자가 무엇을 관찰할지와 그 차이를 어떻게 해석할지를 함께 제공한다. 자료를 배치했다는 사실만으로 설명이 완결되지는 않는다.

질문에서 해석으로

자료 앞에서는 비교할 대상·변화·조건을 짚는다. 자료 뒤에서는 발견한 차이를 본문의 모델이나 판단에 연결하고, 그 자료만으로 결론낼 수 없는 범위도 밝힌다. 주변 설명 없이도 읽혀야 하는 자료라면 제목·캡션·범례에 이 역할을 담을 수 있다.

예를 들어 CPU와 지연 시간이 함께 표시된 그림에서 독자가 두 선의 동행과 어긋남을 볼지 먼저 정한다. 그 차이가 시사하는 원인 후보를 설명하되 하나의 패턴으로 원인을 확정하지 않는다. 코드도 같은 방식으로 볼 입력·상태·결과를 알려 줄 수 있다.

독자가 이미 아는 내용을 그림 앞뒤에 반복하는 규칙은 아니다. 필요한 안내량은 자료의 복잡성과 독자의 전제 지식에 맞춘다. 모든 그림을 순서대로 세부 해설하거나 자기 기록의 자유로운 전개를 고정하지 않는다.

근거와 연결

• 기술 글의 설명 구조와 시각 자료 - Kciter > 그림 앞의 질문과 뒤의 해석: 모니터링 글의 지표·차트·주변 해석에서 종합한 작성 판단. 저자가 선언한 공통 규칙이나 학습 효과의 실험 결과는 아니다.
• 다이어그램 유형은 보여줄 관계에 맞춰 고른다는 자료 내부에서 어떤 관계를 표현할지 다룬다. 이 노트는 자료와 주변 설명을 잇는 독자의 읽기 경로를 다룬다.
• 비교 데모는 공통 조건과 바뀌는 변수를 드러낸다
• UI 디자인
• Atomic Notes