블로그 글과 지식형 글을 분리하기 위한 Glossary 도입 방침

Decision

• 문제-검증-해결 흐름의 시계열 글은 blog에 둔다.
• 정의, 사양 메모, 비교표 같은 장기 참조 콘텐츠는 glossary에 둔다.
• 새 glossary 컬렉션을 추가하고 /glossary, /{lang}/glossary에 목록/상세를 구현한다.
• 기존 blog 글은 즉시 이동하지 않고, 신규 콘텐츠부터 분류를 적용한다.

Context

현재는 지식 메모와 블로그 글이 blog에 함께 있다.
이 상태에서는 독자 탐색 동선과 작성 규칙이 모두 모호해지기 쉽다.

• 블로그 글: 공개 시점과 맥락 흐름이 중요
• 지식 글: 지속 업데이트와 재사용성이 중요

단일 컬렉션 운용은 목록 UI, 내부 링크, SEO 의도를 혼합시킨다.

Options

• Option A: 모두 blog에 두고 태그로만 구분한다.
• Option B: blog와 glossary를 분리한다(채택).
• Option C: 이름 규칙만 먼저 분리하고 구현 분리는 나중에 한다.

Rationale

• blog는 시계열, glossary는 참조형이라는 읽기 모델이 명확해진다.
• 컬렉션을 분리하면 정렬, 필터, 강조 방식 등 UI를 목적별로 조정하기 쉽다.
• URL 분리는 검색 엔진에도 페이지 의도를 더 명확히 전달한다.

Consequences

• src/content.config.ts에 glossary 컬렉션 스키마를 추가한다.
• content/glossary/를 만들고 lang + slug 기반 ID를 생성한다.
• src/pages/glossary/*, src/pages/[lang]/glossary*에 정적 라우트를 추가한다.
• i18n 사전에 glossary 문구를 추가한다.
• 기존 글 이동은 점진적으로 진행하고, 필요하면 리다이렉트 정책을 별도 ADR로 정의한다.