문서 메타데이터 가이드¶

문서의 메타데이터는 각 페이지의 주제와 범위를 명확하게 나타내고 관련 정보를 쉽게 탐색할 수 있도록 돕습니다.

기본 항목¶

항목	독자가 확인할 수 있는 내용
제목	문서의 중심 주제
설명	본문에서 다루는 범위와 핵심 내용
태그	함께 탐색할 수 있는 관련 주제
상태	초안·검토완료·기준문서·연결문서 등 현재 역할
검토일	본문·출처·링크·안전 표현을 마지막으로 실제 확인한 날짜

제목¶

문서가 무엇에 관한 것인지 가장 직접적으로 표현합니다.

증상·질환은 일반적으로 사용하는 명칭을 우선하고, 질문형 콘텐츠는 실제 질문 형태의 제목을 사용할 수 있습니다.

설명¶

문서에서 다루는 범위를 간결하게 설명합니다. 다른 페이지와 같은 문장을 반복하거나, 본문에 없는 치료·효과를 설명에 넣지 않습니다.

증상·질환 — 주요 증상, 감별, 한의학적 해석과 치료
방제 — 출전, 구성, 방의, 전통적 활용과 관련 연구
본초 — 기원, 성미·귀경, 효능, 처방에서의 역할과 관련 연구
질문형 문서 — 질문의 핵심 내용과 함께 살펴볼 사항

태그¶

태그는 문서의 주요 주제와 분류를 나타냅니다. 유사한 표현을 과도하게 나열하기보다 실제 탐색에 도움이 되는 핵심어를 사용합니다.

상태와 검토일¶

일반 공개 문서는 status와 last_reviewed를 함께 기록합니다. 자동 빌드 날짜를 검토일로 쓰지 않으며, 최신 연구를 추가하거나 안전성·핵심 결론을 바꾼 날에는 실제 검토일을 갱신합니다. 상태 값의 정의와 연결문서 예외는 문서 상태·품질 정책에서 확인합니다.

본문 제목¶

본문의 큰 제목은 페이지의 중심 주제를 명확하게 나타내며 문서 제목과 의미상 일치하도록 작성합니다.

문서 첫 부분¶

증상이나 질문을 다루는 문서는 문서 앞부분에서 핵심 내용을 쉽게 확인할 수 있도록 구성합니다.

이후 증상의 특징, 감별, 한의학적 해석, 치료와 관련 자료를 단계적으로 살펴볼 수 있도록 합니다.

내부링크¶

관련 증상·본초·방제·치료·고전·연구 문서로 자연스럽게 연결합니다.

세부문서는 핵심색인과 분야별 허브를 통해 탐색할 수 있습니다. 제목을 바꿀 때도 기존 URL과 인용에 쓰인 제목 앵커를 확인해, 이전 링크로 접근하는 독자가 내용을 찾을 수 있도록 합니다.

참고자료¶

고전이나 현대 연구를 인용하는 경우 문서의 내용과 직접 관련된 자료를 우선하며, 확인 가능한 서지정보가 있는 경우 함께 기록합니다.