문제#
문서 분량을 줄이고 주제를 나눴지만 생성 화면에서는 허브, 상세 문서와 계획이 모두 같은 모양이었다. 핵심 결론은 제목과 문서 도구, 시각 자료 다음에 나타났고 글자가 포함된 넓은 도식은 본문 폭에 맞춰 축소되면서 읽기 어려워졌다.
결정#
page_type을 생성 HTML의 화면 역할로 사용한다.- 첫
한 문장 결론,핵심 결론또는결론절을 제목 바로 아래의 결론 레일로 올린다. - 결론 레일 다음에 선택적 시각 자료, 문서 도구와 본문을 배치한다.
- 홈의 첫 이동 목록은 별도 이미지 대신 반응형 HTML 읽기 경로로 표시한다.
- 사이드바는
시작 → 조사 → 조사 결과 → 결정 기록 → 원본·근거순으로 배치한다. - 결정 기록과 원본·근거는 기본으로 접고, 해당 문서를 읽을 때만 자동으로 펼친다.
- 글자가 포함된 도식과 차트는 본문을 넘치지 않는 가로 이동 영역에서 최소 읽기 폭을 유지하고 원본 보기를 제공한다.
- 표 본문은 15px을 최소 기준으로 사용한다.
- 페이지마다 시각 자료를 의무화하지 않는다. 판단 시간을 줄이는 시각 자료 하나를 우선한다.
화면 순서#
문서 맥락
제목과 설명
핵심 결론
선택적 시각 자료
목차와 문서 정보
본문
재검토 조건#
- 첫 화면에서 현재 결론을 찾기 어렵다는 피드백이 반복된다.
- 도식의 가로 이동이 확대나 원본 보기보다 더 불편하다.
- 홈의 읽기 경로가 팀원의 실제 탐색 순서와 맞지 않는다.
- 결정 기록이나 원본·근거를 반복해서 펼치는 행동이 실제 탐색을 방해한다.
- 표 글자 확대가 작은 화면에서 필요한 비교를 지나치게 분절한다.
관련 문서: ADR-0003: Wiki 읽기 인터페이스, ADR-0005: Wiki 디자인 시스템, ADR-0006: 인포그래픽 디자인 가이드, ADR-0007: Wiki 페이지 작성 규칙