Einführungsrichtlinie für die Snippets-Collection für leichte Praxisnotizen
Decision
- Kurze Praxisnotizen (Command-Fragmente, minimale Abläufe, kurze Konfigurationsbeispiele) werden in
snippetsabgelegt. - Das Inhaltsmodell nutzt drei Typen: chronologische Beiträge in
blog, Wissens-/Definitionsseiten inglossary, praktische Fragmente insnippets. - Die Collection
snippetswird ergänzt und als Liste/Detail unter/snippetsund/{lang}/snippetsbereitgestellt. _template.ja.mdbleibt bestehen; Dateien mit_-Präfix werden von der Veröffentlichung ausgeschlossen.
Context
Für kurze Praxisnotizen gab es bisher keinen klaren Ablageort:
- Zu kurz für einen Blogbeitrag
- Keine Definitionsseite für das Glossar
Werden solche Inhalte in blog gemischt, verwischt die Seiten- und Suchintention.
glossary ist definitionsorientiert und passt nicht gut zu command-zentrierten Snippets.
Options
- Option A: Kurze Praxisnotizen in
blogbelassen. - Option B: Unter
glossaryeinsortieren. - Option C: Eigene Collection
snippetseinführen (gewählt).
Rationale
- Leser erhalten klare Einstiegspunkte: Beiträge, Wissen und praktische Snippets.
- Durch die Trennung bleibt der Qualitätsmaßstab für
blog-Artikel stabil. - Getrennte URLs machen die Seitenintention für Suchmaschinen klarer.
Consequences
snippets-Collection-Schema insrc/content.config.tsergänzen.src/features/snippets/*,src/pages/snippets/*undsrc/pages/[lang]/snippets*hinzufügen.snippets-Bezeichnungen in Header-Navigation und i18n-Wörterbüchern ergänzen.- Ersten Inhalt (Batch-Konvertierungsnotiz mit
avifenc) nachcontent/snippets/migrieren.
hsb.horse