검색 노출 0은 누락이 아닌 색인 진행 중

문서 한 줄이 팀의 불안감을 어떻게 없앨 수 있는지 배웠던 순간.

배경: "왜 노출이 0인가?"

SEO 인프라 정책 수립 과정에서, 3종의 서비스(kpopdex, vtuber, blindbox)를 새로이 색인 대상으로 편입할 때였다. 보통 이런 변경은 개발팀이 몇 줄의 환경 설정 또는 정책 레지스트리 수정으로 끝낸다. 그런데 며칠이 지났는데도 검색 대시보드에 "노출 0" 상태가 계속 표시되니, 팀에서 자연스레 의심이 생긴다.

• 설정이 제대로 안 됐나?
• 색인이 누락됐나?
• 배포가 완료되지 않았나?

문제는 이런 불안감이 쌓이면 중복 확인, 불필요한 롤백, 또는 잘못된 "긴급 수정"으로 이어진다는 것. 기술 부채가 아닌 심리적 부채가 팀에 쌓인다.

문제의 원인: 명백한 상태도 명백하지 않음

노출 0이 "누락"을 의미하는 건 아니다. 색인 엔진에 새로운 서비스를 편입할 때의 일반적인 라이프사이클은:

1. 설정 적용 (대체로 즉시)
2. 크롤러가 발견 시작 (몇 시간 ~ 수일)
3. 색인 진행 중 (상태: "노출 0" + 색인율 증가)
4. 색인 완료 (노출 수 증가)

팀 입장에서는 "설정했는데 왜 노출이 0?"이라는 불안이 자연스럽다. 대시보드 화면만 봐서는 "진행 중"과 "실패"를 구분하기 어렵기 때문이다.

해결: 문서화로 "설정된 상태"를 명시하다

docs/seo-infra.md 를 업데이트해 다음을 명확히 했다:

핵심은 "노출 0 = 누락"이 아니라 "노출 0 = 진행 중" 이라는 점을 문서에 명시하는 것. 이렇게 하면:

• 대시보드를 보고 불안해하는 팀원에게 "문서 봐"라고 할 수 있다.
• 새로 온 팀원도 처음부터 올바른 이해를 갖는다.
• 2주 뒤 누군가 "이 항목 왜 0이에요?"라고 물어올 때 답이 이미 준비되어 있다.

회고: 개발자 관점에서 본 "문서"의 가치

내가 처음엔 "설정만 했으니 이제 끝"이라고 생각했다. 그런데 팀의 불안감과 중복 확인들을 보면서 깨달았다:

명백한 것도 문서화하지 않으면, 팀의 맥락과 현실이 괴리된다.

코드 리뷰에서 "왜?"를 묻는 습관이 있다면, 문서에도 같은 질문을 답해야 한다:
- "왜 이 상태인가?"
- "이게 정상인가?"
- "언제 바뀔 예정인가?"

특히 검색 노출 같은 "외부 시스템에 의존한 메트릭"은 시간차가 있기 마련이다. 그 시간차 동안 팀의 신뢰를 잃지 않으려면, 상태 변화의 예상 흐름을 미리 문서화해 두는 게 필요하다.

이번 작업은 코드 한 줄 없는 "docs 커밋"이었지만, 팀 관리 입장에서 보면 중요한 신뢰 구축 활동이었다. 불필요한 재작업을 막고, 팀의 인지 부하를 줄이고, 명확한 기준선을 만드는 것. 그게 바로 좋은 문서화다.

다음엔 "단순히 설정 완료"를 넘어 "팀이 어떤 의문을 가질 만한가"를 먼저 물어봐야겠다.

🛒 이 글과 어울리는 추천 상품

• 모니터 쿠팡에서 보기 →
• 사무의자 쿠팡에서 보기 →
• 책상조명 쿠팡에서 보기 →

*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.