logo hsb.horse

Architecture Decision Record

Einführungsrichtlinie für Glossar zur Trennung von Blogbeiträgen und Wissensinhalten

Zeitbezogene Beiträge bleiben im blog, langfristige Referenzinhalte wechseln ins glossary, mit getrennten URLs, Collections und Navigationspfaden.

Angenommen #content #glossary #blog #information-architecture #seo

Einführungsrichtlinie für Glossar zur Trennung von Blogbeiträgen und Wissensinhalten

Decision

  • Chronologische Beiträge (Problem, Untersuchung, Lösung) bleiben in blog.
  • Langfristige Referenzinhalte wie Definitionen, Spezifikationsnotizen und Vergleichstabellen gehen in glossary.
  • Eine neue Collection glossary wird ergänzt, mit Listen- und Detailrouten unter /glossary und /{lang}/glossary.
  • Bestehende blog-Einträge werden nicht sofort migriert; die neue Klassifizierung gilt zunächst für neue Inhalte.

Context

Derzeit sind Wissensnotizen und Blogbeiträge gemeinsam in blog abgelegt.
Dadurch werden sowohl die Lesernavigation als auch redaktionelle Regeln unscharf.

  • Blogbeiträge: Veröffentlichungszeitpunkt und zeitlicher Kontext sind wichtig
  • Wissensinhalte: Kontinuierliche Aktualisierung und Wiederverwendung sind wichtig

Eine einzelne Collection mischt UI-Zweck, interne Verlinkung und SEO-Intention.

Options

  • Option A: Alles in blog behalten und nur per Tags unterscheiden.
  • Option B: In blog und glossary trennen (gewählt).
  • Option C: Nur Namensregeln trennen und die Implementierung später nachziehen.

Rationale

  • Das Lesemodell wird klar: zeitbasiertes blog vs referenzorientiertes glossary.
  • Durch die Trennung können zukünftige UI-Optimierungen je Inhaltstyp gezielt erfolgen (Sortierung, Filter, Hervorhebungen).
  • Getrennte URLs machen die Seitenintention auch für Suchmaschinen eindeutiger.

Consequences

  • glossary-Collection-Schema in src/content.config.ts ergänzen.
  • content/glossary/ anlegen und IDs über lang + slug erzeugen.
  • Statische Routen unter src/pages/glossary/* und src/pages/[lang]/glossary* hinzufügen.
  • Glossary-Texte in die i18n-Dictionaries aufnehmen.
  • Bestehende Inhalte schrittweise migrieren; Redirect-Policy bei Bedarf in separatem ADR definieren.