문서 게시와 운영 관측은 갱신 주기에 맞춰 분리한다

문서와 링크·검색의 일관성이 중요한 내용은 같은 버전의 게시 묶음으로 제공하고, 더 자주 바뀌는 운영 상태는 별도의 관측 경로로 조회할 수 있다. 같은 화면에 나온다는 이유만으로 모든 데이터의 갱신 시점과 제공 방식을 같게 만들 필요는 없다.

문서 묶음에서는 본문·색인·링크가 같은 원천 버전을 가리키는지가 중요하다. 운영 관측에서는 무엇을 언제 조회했는지와 조회 성공·실패, 마지막으로 성공한 값의 시점이 중요하다. 문서 게시를 끝냈다는 사실은 시스템이 지금 정상이라는 증거가 아니다.

새 묶음 생성에 실패해 이전 문서를 유지할 때에도 최근 갱신 실패는 별도로 남길 수 있다. 오래된 문서를 제공하는 일과 그 문서가 최신이라고 표시하는 일을 분리한다. 보존된 과거 묶음의 공개 철회가 필요하다면 그 직접 주소와 캐시도 같은 철회 범위로 검토한다.

이 구조는 설명 문서와 상태 관측의 갱신 주기가 실제로 다른 경우에 유용하다. 모든 사이트에 별도 API를 추가하라는 규칙은 아니며, 관측할 데이터·허용 지연·운영 부담이 구체화되면 범위를 정한다.

근거와 연결