문서 상태·품질 정책¶
품질감사의 점수는 수정 우선순위를 찾기 위한 신호이지 모든 짧은 문서를 길게 만들어야 한다는 뜻은 아닙니다.
문서 유형¶
기준문서(canonical)¶
해당 주제의 가장 충실한 설명을 담는 문서입니다. 출전·구조·임상 연결·현대 연구 등 주제에 필요한 깊이를 확보합니다.
연결문서(canonical-bridge)¶
과거 URL이나 다른 탐색경로를 보존하면서 기준문서로 안내합니다. 의도적으로 짧을 수 있으며 중복 내용을 다시 작성하지 않습니다.
템플릿¶
작성 형식을 위한 파일입니다. 본문 길이 점수로 임상문서와 동일하게 평가하지 않습니다.
참고문헌¶
출처 목록이 목적이므로 내부링크 수나 본문 길이를 일반 임상문서와 동일하게 평가하지 않습니다.
상태 값과 검토일¶
| 상태 | 의미 | 공개 문서에서 필요한 조치 |
|---|---|---|
| 초안 | 구조·출처·안전성 중 일부가 아직 검토 중 | 초안임을 드러내고 기준문서로 인용하지 않음 |
| 검토완료 | 현재 범위에서 본문·링크·출처·안전 표현을 확인 | last_reviewed에 실제 검토일 기록 |
| 기준문서 | 해당 주제의 대표 설명으로 다른 문서가 연결 | 중복 페이지를 만들지 않고 정기적으로 출처·링크 재검토 |
| 연결문서 | 기존 URL·탐색경로를 기준문서로 이어 주는 짧은 문서 | canonical-bridge 역할과 목적지를 명시 |
last_reviewed는 파일 생성일이나 자동 빌드일이 아니라, 사람이 본문과 근거를 실제로 확인한 날짜입니다. 내용이 크게 바뀌었거나 최신 근거·지침을 갱신했다면 검토일도 함께 갱신합니다.
최소 메타데이터¶
일반 공개 문서는 title, description, status, last_reviewed를 기본으로 합니다. 검색 진입점은 실제 환자 표현을 keywords에, 분야 연결이 필요한 문서는 핵심 주제를 tags에 선택적으로 기록합니다. 연결문서·템플릿·참고문헌은 역할에 맞는 별도 기준을 적용할 수 있습니다.
현대화 원칙¶
- 같은 주제의 중복 문서를 각각 확장하지 않습니다.
- 가장 적합한 한 문서를 기준문서로 삼습니다.
- 과거 URL은 연결문서로 보존하여 링크 단절을 막습니다.
- 환자 진입문서는 위험신호·감별·변증·치료·근거 흐름을 우선합니다.
- 전문 본초·방제·경락 문서는 출전·용량·유주·전체 혈위 등 분야별 깊이를 확보합니다.
- 기존 페이지 뒤에
추가 확장을 반복해서 붙이지 않고 본문 구조 안에 통합합니다.
감사에서 제외하거나 별도 평가할 영역¶
templates/, 각종 references.md, canonical-bridge 문서는 일반 임상 콘텐츠와 별도 기준으로 평가하는 것이 적절합니다.
→ 가이드 허브