큐레이션 산출물에 해당하는 것
문서화보다 선택이나 순서 정하기가 주된 역할인 모든 페이지가 해당합니다.- 솔루션 가이드(
content-type: solution-guide): 각각 링크의 연쇄와 의사결정 표로 구성됩니다. - 라우터 및 랜딩 페이지(
content-type: router-landing): 무엇을 노출할지 선택하는 섹션 인덱스를 포함합니다. - 커리큘럼 허브 및 학습 트랙 인덱스(
content-type: curriculum-hub): 기존 페이지들을 하나의 경로로 순서를 정합니다. - 선택 및 비교 페이지: 대안에 관한 날짜가 있는 사실을 제시하는 모든 페이지 (클라이언트 선택, 도구 매트릭스).
- 프롬프트 라이브러리 및 AI 온보딩 페이지: 특정 제품 인터페이스를 참조하는 큐레이션된 프롬프트와 통합 지침.
last-reviewed: 계약
모든 큐레이션 산출물은 프런트매터에 리뷰 스탬프를 포함합니다.
산출물 유형별 점검 주기
주기를 넘긴 페이지가 자동으로 틀린 것은 아니지만 검증되지 않은 상태이며,
검증되지 않은 큐레이션은 결함으로 취급됩니다. 이러한 페이지는 다음 점검에서
가장 먼저 처리됩니다.
점검에서 하는 일
각 점검 단계에서는 유형별 주기 대비last-reviewed:가 가장 오래된
큐레이션 산출물을 골라 재검증합니다.
- 연쇄 무결성: 링크 정책에 따라 외부 사이트로 나가는 링크를 포함하여 페이지의 모든 링크가 정상적으로 연결되는지 확인합니다. 솔루션 가이드의 경우 가이드 페이지만이 아니라 가이드가 순서를 정한 연쇄 전체가 대상입니다. 죽은 링크 하나가 잘 닦인 경로를 끊어 놓기 때문입니다.
- 핵심 주장: 기본값, 임계값, 버전 번호, “기준 시점(as of)” 표시를 소스와 대조하여 재확인합니다. 모든 “기준 시점” 날짜는 재확인(및 날짜 갱신)하거나 해당 주장을 수정합니다.
- 스탬프: 같은 변경에서
last-reviewed:를 점검 날짜로 갱신하여 스탬프와 검증이 서로 어긋나지 않게 합니다.
목록 제외 규칙
큐레이션 페이지는 무언가를 추천합니다. 더 이상 지지할 수 없는 추천은 단서를 달아 남겨 두지 않고 제거합니다.- 점검 중 큐레이션 항목(외부 링크, 나열된 도구, 추천 옵션)이 죽었거나, 지원 중단되었거나, 더 이상 문서가 추천할 만한 것이 아니라고 판단되면, 해당 항목은 경고를 달아 그대로 두지 않고 그 점검의 변경에서 제거하거나 교체합니다.
- 큐레이션 페이지 전체를 더 이상 검증할 수 없는 경우(주제가 지원 중단되었거나, 해당 여정이 더 이상 존재하지 않는 경우), 페이지를 내비게이션에서 제거하고 리디렉션 지침에 따라 리디렉션하며, 제거 사실을 pull request에 기록합니다.
새 큐레이션 페이지 추가
새 큐레이션 산출물은 병합 시점에 점검 순환에 들어갑니다.- 리뷰 주기 내의 날짜(일반적으로 병합 날짜)로 설정된
last-reviewed:와 콘텐츠 유형 계약이 요구하는content-type:을 포함합니다. - pull request에 산출물 유형을 명시하여, 리뷰어가 어떤 주기를 적용받기로 했는지 알 수 있게 합니다.
- 예외는 없습니다. 해당 유형의 점검 주기를 지킬 수 없는 큐레이션 페이지는 큐레이션 페이지로 배포해서는 안 됩니다.