Glossary introduction policy to separate blog posts and knowledge entries
Decision
- Keep chronological posts (problem, investigation, solution) in
blog. - Keep long-lived reference content such as definitions, spec notes, and comparison tables in
glossary. - Add a new
glossarycollection and implement index/detail routes at/glossaryand/{lang}/glossary. - Do not migrate existing
blogentries immediately; apply this classification to new content first.
Context
Knowledge notes and blog posts are currently mixed in blog.
That makes both reader navigation and authoring rules ambiguous.
- Blog posts: publication context and timeline matter
- Knowledge entries: ongoing updates and reuse matter
With one collection, list UX, internal linking intent, and SEO intent become mixed.
Options
- Option A: Keep everything in
blogand separate only with tags. - Option B: Split into
blogandglossary(chosen). - Option C: Split naming rules first and delay implementation changes.
Rationale
- The reading model becomes explicit: timeline-oriented
blogvs reference-orientedglossary. - Collection split allows future UI optimization per content type (sorting, filters, emphasis).
- URL separation makes page intent clearer for search engines.
Consequences
- Add a
glossarycollection schema insrc/content.config.ts. - Create
content/glossary/and generate IDs withlang + slug. - Add static routes under
src/pages/glossary/*andsrc/pages/[lang]/glossary*. - Add glossary copy in i18n dictionaries.
- Migrate existing entries gradually; define redirect policy in a separate ADR if needed.
hsb.horse