logo hsb.horse

Architecture Decision Record

Politique d’introduction de la collection Snippets pour les notes pratiques légères

Séparer dans snippets les notes pratiques trop courtes pour le blog, avec des pages liste/détail sur /snippets et /{lang}/snippets.

Accepté #content #snippets #blog #information-architecture #seo

Politique d’introduction de la collection Snippets pour les notes pratiques légères

Decision

  • Les notes pratiques courtes (fragments de commandes, procédures minimales, exemples de configuration) sont placées dans snippets.
  • Le modèle de contenu est organisé en 3 types: articles chronologiques dans blog, contenus de référence dans glossary, fragments pratiques dans snippets.
  • Ajouter la collection snippets et implémenter les routes liste/détail sur /snippets et /{lang}/snippets.
  • Conserver _template.ja.md et exclure de la publication les fichiers préfixés par _.

Context

Le modèle actuel n’offrait pas d’emplacement clair pour les notes pratiques courtes:

  • Trop courtes pour un article de blog
  • Pas adaptées à un glossaire de définitions

Les mélanger dans blog brouille l’intention de la liste et l’intention de recherche.
glossary reste orienté définitions et ne correspond pas aux snippets orientés commandes.

Options

  • Option A: Garder ces notes courtes dans blog.
  • Option B: Les placer dans glossary.
  • Option C: Créer une collection dédiée snippets (choix retenu).

Rationale

  • Les points d’entrée deviennent plus clairs: articles, connaissances, snippets pratiques.
  • Isoler ces notes aide à conserver le niveau éditorial du blog.
  • La séparation des URL clarifie mieux l’intention des pages pour les moteurs de recherche.

Consequences

  • Ajouter la définition de collection snippets dans src/content.config.ts.
  • Ajouter src/features/snippets/*, src/pages/snippets/* et src/pages/[lang]/snippets*.
  • Ajouter les libellés snippets dans la navigation d’en-tête et les dictionnaires i18n.
  • Migrer le premier contenu (mémo de conversion en lot avec avifenc) vers content/snippets/.