새로운 서비스 SEO 관리에 편입하고 기존 오류 정정

SEO 인프라 문서를 업데이트했다. blindboxdex라는 새로운 서비스를 SEO 관리 대상에 편입하면서, 동시에 vtuberprofile에서 siteFullUser 기능이 라이브되면서 생긴 정책 변경을 반영한 것이다.

SEO 문서 관리의 필요성

팀에서 여러 개의 서비스를 운영하다 보면, 각 서비스마다 SEO 설정 방식이 다르고, 시간에 따라 기능이 추가·변경된다. 이런 상황에서 SEO 인프라 문서 없이 관리하려면 어떤 문제가 생길까?

• 새로운 팀원이 온보딩될 때마다 "어 이 서비스의 SEO는 어떻게 관리해?" 라고 묻는다.
• 한 서비스의 기능 업데이트가 있을 때 다른 팀 담당자와 정책이 맞는지 확인할 수 없다.
• 서비스가 늘어나면서 "언제부터 이 설정이 바뀌었더라?" 같은 히스토리 추적이 불가능해진다.

그래서 seo-infra.md 문서를 단일 진실 공급원으로 둔다. 이 문서 하나가 모든 서비스의 SEO 정책을 대표하고, 팀 전체가 참고하는 기준이 되는 셈이다.

이번 업데이트: 두 가지 변경사항

blindboxdex 편입의 배경: 새 서비스가 런칭되거나 기존 서비스를 SEO 관리 체계에 추가하게 되면, 코드에만 기능을 넣는 것으로는 부족하다. 팀 전체가 "이 서비스는 어떤 SEO 정책을 따르는가"를 명확히 알아야 한다. 특히 여러 팀이 함께 일할 때 문서화 없으면 나중에 불일치가 생긴다. 누군가는 "이건 A 방식이겠지" 하고 다른 누군가는 "아니야 B 방식이겠지" 하다가 결국 일관성 있는 SEO 정책이 깨진다.

vtuberprofile의 siteFullUser 정정: 어떤 기능이 "라이브"라는 것은 프로덕션 환경에서 실제로 동작하기 시작했다는 뜻이다. 이전에는 준비 중이거나 파일럿 단계였다면, 이제 정식 기능이 된 것이다. 그렇다면 SEO 정책도 그에 맞춰 반영되어야 한다. 문서가 현실과 어긋나면, 나중에 누군가는 "어? 이건 왜 이렇게 설정되어 있지?" 하면서 똑같은 실수를 반복한다.

작은 정정의 가치

사실 이건 "버그 수정" 같은 화려한 작업은 아니다. 단순 문서 업데이트다. 하지만 이런 정정 작업이 축적되면 팀의 신뢰도가 올라간다.

• 신입 온보딩 속도: 새로운 팀원이 현재 상황을 더 빠르게 이해한다. 문서가 명확하면 "누가 이 부분 설명해줄래?" 같은 질문이 줄어든다.
• 실수 방지: "어느 서비스는 이 정책을 따르는데, 어느 서비스는 아닌가?" 같은 혼동이 줄어든다. 일관성이 높을수록 실수할 여지가 줄어든다.
• 의사결정 기록: 왜 이 정책을 채택했는지 나중에 추적할 수 있다. "아 그때 blindboxdex 편입하면서 이렇게 결정했구나" 하고 이해할 수 있다.

SEO처럼 서비스 간 일관성이 중요한 영역에서, 문서의 정합성을 지키는 것은 기술 부채를 미리 지우는 행동이다. 작아 보이는 정정이 모여서 팀의 체계를 견고하게 만든다.

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

• 사무의자 쿠팡에서 보기 →
• 모니터 쿠팡에서 보기 →
• 노이즈캔슬링헤드폰 쿠팡에서 보기 →

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