# Documentation

Ce projet fait partie de **May Facturation**, documenté dans le site Docusaurus interne `documentation.may-software.com` (dépôt séparé — repo GitLab `documentation-may-software`, en local : `c:\wamp64\www\dev\may-software\may-software\documentation may software`).

Section correspondante : `docs/may-facturation/` (`index.md`, `architecture.md`, `api-reference.md`, `deploiement.md`, `pieges-connus.md`).

## Quand mettre à jour la doc Docusaurus

Après un changement significatif dans ce projet (nouvelle route API, évolution Factur-X/conformité ISCA, intégration Plateforme Agréée, nouvelle étape de déploiement, piège/bug non trivial résolu) :

1. Documente-le d'abord ici comme d'habitude (le journal de développement du README reste la source de vérité chronologique).
2. Répercute le contenu **structurant et réutilisable** dans la page Docusaurus correspondante :
   - Nouvelle route → `api-reference.md` (routes extraites du code, pas du journal — rester factuel)
   - Changement d'architecture, du modèle multi-tenant, ou de la conformité ISCA/Factur-X → `architecture.md`
   - Piège généralisable (pas un simple bug métier ponctuel) → `pieges-connus.md`
   - Étape d'installation/déploiement (dont Passenger/o2switch) → `deploiement.md`
3. Ne duplique jamais le journal de développement complet dans Docusaurus — seulement une synthèse. Voir les pages existantes pour le ton et le niveau de détail attendus.
4. Ne touche à `documentation.may-software.com` que pour cette mise à jour ciblée, jamais pour une refonte non demandée.