본문으로 건너뛰기

사실 검증 및 최신성

중급

"항상 최신"이라는 약속은 마법이 아니라 간단하고 정직한 시스템으로 지켜집니다. 기여할 때 이 약속을 지키는 방법을 소개합니다.

변하지 않는 사실 vs 변동성 있는 사실​

  • 변하지 않는 사실(Evergreen) — 변하지 않는 개념(LLM이란 무엇인가, RAG란 무엇인가). 날짜가 필요 없습니다.
  • 변동성 있는 사실(Volatile) — 릴리스마다 바뀌는 모든 것: 모델 이름/ID, 가격, 한도, UI 라벨, 베타/기능 가용성, 정확한 CLI 플래그. 반드시 날짜와 출처를 함께 표기해야 합니다.

변동성 있는 사실에 표기하기​

레벨 배지 바로 아래에 <VerifyNote> 컴포넌트를 사용하세요:

<VerifyNote lastVerified="2026-06-20" source="https://docs.anthropic.com/...">
One line on what's volatile here and to confirm at the source.
</VerifyNote>
  • lastVerified = 직접 출처와 대조하여 확인한 날짜.
  • source = 권위 있는 공식 페이지.

모델 관련 사실을 절대 하드코딩하지 마세요​

모델 ID/가격/컨텍스트는 오직 data/models.json에만 존재하며, 모델 페이지에서 <ModelTable />로 렌더링됩니다. 본문에서는 모델 ID나 가격을 직접 쓰는 대신 그곳으로 링크하세요. 모델 업데이트는 그 JSON에 한 줄만 수정하면 됩니다(완벽한 첫 PR감입니다).

needs-verification에 대응하기​

자동화(그리고 독자들)는 사실이 오래되었을 수 있을 때 needs-verification 라벨이 붙은 이슈를 엽니다. 이를 해결하려면:

  1. 공식 출처와 대조하여 주장을 확인합니다.
  2. 정확하다면 → lastVerified를 오늘 날짜로 갱신합니다.
  3. 바뀌었다면 → 내용 과 날짜를 모두 수정하고, 출처를 링크합니다.
  4. 모델 관련 사실이라면 → 본문이 아니라 data/models.json을 업데이트합니다.

정직성 원칙​

:::tip 오래된 날짜는 결함이 아니라 기능입니다 몇 달 전의 lastVerified는 우리가 실패했다는 뜻이 아닙니다. 독자에게 그 사실을 다시 확인하라고 알려주는 것입니다. 자신만만하게 틀린 것보다 정직하게 오래된 날짜가 낫습니다. 실제로 다시 검증하지 않은 날짜는 갱신하지 마세요. :::

다음 단계​