logo hsb.horse

Architecture Decision Record

ADR

Des décisions courtes et structurées qui expliquent pourquoi un choix a été fait.

Par année

Accepté #search #pagefind #architecture #i18n

Politique d’adoption de la recherche du site avec Pagefind

Adopter Pagefind pour la recherche plein texte statique et standardiser les routes de recherche localisées avec l’intégration au build.

2026-02-08-008-pagefind-site-search

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

Politique d’introduction du Glossaire pour séparer articles de blog et contenus de connaissance

Séparer les articles chronologiques dans blog et les contenus de référence long terme dans glossary, avec URL, collection et navigation dédiées.

2026-02-08-009-glossary-content-separation-policy

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

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.

2026-02-08-010-snippets-content-collection-design

Accepté #pwa #i18n

Stratégie d'i18n du manifest PWA

Générer des manifests spécifiques aux locales avec lang/name/short_name localisés.

2026-02-08-011-pwa-manifest-locale-strategy

Accepté #seo #metadata #aio #structured-data #i18n

Politique d’optimisation SEO, métadonnées et AIO

Standardiser title/description, canonical/hreflang, OGP/Twitter et les données structurées pour améliorer la réutilisation dans les résultats de recherche et les résumés IA.

2026-02-07-005-seo-metadata-aio-strategy

Accepté #analytics #ga4 #partytown #performance #privacy

Politique d’intégration de Partytown et Google Analytics (GA4)

Introduire GA4 (G-WZ3RT34EZZ) via Partytown pour démarrer la mesure des pages vues tout en limitant l’impact sur le thread principal.

2026-02-07-006-partytown-google-analytics-integration

Accepté #tooling #quality #git-hook

Automatisation des hooks Git avec lefthook

Adopter lefthook pour exécuter automatiquement le formatage et le lint Biome au commit et au push.

2026-02-06-004-lefthook-git-hooks-automation

Accepté #astro #i18n #seo #architecture

Stratégie d’URL i18n pour un site Astro

Conserver le japonais comme langue par défaut (racine) et servir les autres langues via des préfixes de sous-répertoire.

2026-02-05-001-astro-i18n-url-strategy

Accepté #blog #content #architecture

Conception de la collection de contenu du blog

Définit le schéma et les règles d’exploitation pour gérer les articles de blog en Markdown/MDX.

2026-02-05-003-blog-content-collection-design

Accepté #docs #process

Conventions ADR

Définir la convention de nommage, la stratégie de langue et le schéma de listing.

2026-02-04-001-adr-structure