#0002 — Hébergement statique uniquement

#Contexte

• Besoin d'une chaîne de documentation personnelle qui reste simple à exploiter sur le long terme.
• Volonté explicite d'éviter toute gestion d'infrastructure serveur, VM ou container.
• Usage ciblé sur de la documentation technique, sans application interactive ni fonctionnalités dynamiques.

#Décision

• S'appuyer sur un générateur de site statique (Rspress) pour construire la documentation.
• Publier le site via GitHub Pages.
• Écarter tout backend ou serveur applicatif.

#Raisons

• Simplicité de mise en œuvre : tout repose sur du contenu Markdown + build statique.
• Maintenance quasi nulle : pas de services à surveiller ni à patcher.
• Coût nul grâce à GitHub Pages.
• Surface d'attaque réduite : aucun composant backend exposé.
• Alignement avec une documentation purement informative.
• Intégration directe avec le dépôt Git qui sert de source unique.

#Conséquences

#Positives

• Déploiement automatisé par pipeline GitHub sur chaque push validé.
• Robustesse élevée (peu d'éléments susceptibles de tomber en panne).
• Accès simple via une URL publique unique.
• Versionnement natif des contenus via Git.

#Négatives

• Absence de fonctionnalités dynamiques (authentification, API, formulaires complexes).
• Dépendance envers l'infrastructure GitHub Pages.
• Limites possibles pour des usages avancés (recherche full-text custom, analytics temps réel, etc.).

#Alternatives considérées

• Hébergement dynamique (Node, PHP, etc.) — rejeté pour éviter une complexité et une maintenance inutiles.
• Auto-hébergement (NAS, VPS, Raspberry Pi) — rejeté à cause des exigences de disponibilité et d'entretien matériel.
• Plateformes alternatives (Netlify, Vercel) — non retenues pour rester sur l'intégration native GitHub.

#Statut

Accepté.