분산된 SEO 속성을 문서 하나로 통합 관리하다
목차
여러 도메인을 운영하다 보니 각 도메인의 SEO 관리 정책과 현황을 한 문서에 정리할 필요가 있었다. 이번에 docs/seo-infra.md 를 최종 완성하면서 LEARN_SLUGS 정의를 확정하고, 별도 운영 중이던 4개 도메인을 편입하고, 현재 연결된 검색 콘솔 5개 속성까지 한데 정리했다.
왜 "최종화"가 필요했나
초기에는 SEO 관리 정책이 여러 곳에 흩어져 있었다. 누군가 새 도메인을 추가해야 할 때, 누군가 검색 콘솔 속성을 확인해야 할 때 인프라 담당자한테 물어야 했다. 각 도메인별로 다른 사람이 다른 기준으로 관리하고 있었고, 이는 팀 확장이나 이슈 대응 시 병목이 됐다. 그래서 "이 도메인들의 SEO 설정, 인증 상태, slug 관리 규칙이 정확히 뭔지 누구든 한 문서 보면 알 수 있도록 하자"는 판단에 도달했다.
최종화에 포함된 것들
LEARN_SLUGS 정의 확정
- 지금까지 암묵적으로 관리되던 slug 생성 규칙을 명시적으로 문서화했다.
- 팀의 새 멤버가 들어올 때 일일이 설명하지 않아도, 문서 한 번 읽으면 규칙을 따를 수 있다는 뜻이다.
별도 도메인 4개 편입
- 그간 "별도로" 관리되던 도메인들을 메인 infra 문서로 통합했다.
- 이는 단순히 목록을 추가한 게 아니라, 각 도메인이 어떤 기준으로 운영되는지, 어떤 인증 상태인지를 공식화하는 작업이다.
- 사일로화된 관리에서 벗어나는 첫걸음이다.
검색 콘솔 5개 속성 명시
- 우리가 현재 모니터링 중인 각 검색 콘솔 속성을 문서에 기록했다.
- "누가 어느 GSC 계정 가져야 하나", "이 도메인 사이트맵 등록됐나" 같은 질문이 줄어들 것이다.
vtuberprofile 인증대기 상태 명시
- 어떤 도메인은 인증 완료, 어떤 건 대기 중인 상태인데, 이를 문서에 명시함으로써 팀의 누구든 "다음에 할 일"을 알 수 있게 했다.
팀장 입장에서 느낀 의미
이런 류의 "정책 문서화" 작업은 코드 커밋처럼 눈에 띄지 않지만, 조직이 커질수록 극도로 중요하다.
투명성의 문제
혼자 알고 있거나 소수만 알고 있는 규칙은, 그 사람이 휴가 가거나 떠나면 난리가 난다. 반면 "여기 있는 문서 읽으면 된다"는 시스템은 의존성을 없앤다. 팀원들의 자율성도 높아진다.
스케일의 문제
도메인이 5개, 10개로 늘어날 때 임시방편의 관리로는 충분하지 않다. 처음부터 "이게 정의된 규칙이구나, 이렇게 추가하면 되겠네"라고 하는 것과, "어, 이건 어떻게 해야 되지?" 하고 나한테 물어보는 것은 전혀 다른 속도다.
온보딩 속도
새 팀원이 들어올 때 SEO 인프라 관련 회의를 길게 할 필요 없다. 문서 한두 장 읽고 나면 충분하다.
앞으로의 유지보수
문서화는 일회성이 아니다. 새 도메인이 추가될 때마다, 검색 콘솔 연결이 변경될 때마다 이 문서도 함께 업데이트되어야 한다. 그래서 팀 내에서 "SEO infra 문서는 현재 상태의 거울"이라는 원칙을 정했다. 정기적으로 실제 상태(검색 콘솔 접근, 도메인 인증 상태)와 문서를 대조해서, 괴리가 생기면 즉시 반영한다.
결국 이 커밋은 기술 부채를 줄인 작업이라기보다는, 조직의 투명성과 재현성을 한 단계 높인 것 같다.
🛒 이 글과 어울리는 추천 상품
*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.
댓글 0
첫 댓글 달아줘.