Contribuer à la documentation

Vous pouvez créer et modifier des pages de documentation sans utiliser d'outils techniques (pas de ligne de commande, pas d'installation). Tout passe par un éditeur web : le CMS.

Comment ça marche

Chaque modification que vous enregistrez crée automatiquement une proposition (une « PR ») qui est relue avant d'être publiée. Rien n'est publié directement : vos changements sont toujours prévisualisés et validés. Aucune base de données n'est utilisée — tout est versionné.

1. Accéder à l'éditeur

1. Ouvrez /admin sur le portail (par exemple https://docs.liliadigital.com/admin).
2. Connectez-vous avec votre compte autorisé (aucune écriture anonyme n'est possible).

Activation en cours

La connexion à l'éditeur nécessite une passerelle d'authentification (OAuth) en cours de mise en service. Tant qu'elle n'est pas activée, l'interface /admin se charge mais la connexion n'est pas encore opérationnelle : rapprochez-vous de l'équipe documentation pour contribuer en attendant.

2. Créer ou modifier une page

1. Choisissez la collection correspondant à l'audience visée : Public, Client ou Interne.
2. Cliquez sur « Nouveau » ou ouvrez une page existante.
3. Remplissez le contenu et les informations de classement :
   • Titre, Description.
   • Tier (audience) — obligatoire : sans lui, l'enregistrement est refusé.
   • Univers, Catégorie, Responsable, Statut, Dernière revue.
4. Insérez des images si besoin (bouton d'upload) : elles sont versionnées avec la page.

3. Enregistrer et suivre la publication

1. Cliquez sur « Enregistrer » : le CMS crée une branche et ouvre une proposition (PR).
2. Une prévisualisation est générée (pour les espaces réservés, elle est protégée : un visiteur anonyme ne peut pas la voir).
3. Un relecteur valide la proposition, puis elle est publiée automatiquement.

Bonnes pratiques

• Doc client = générique uniquement. N'ajoutez jamais de données propres à un compte (noms, e-mails, contrats, factures) : ces informations vivent dans le portail client.
• Renseignez un Statut honnête (draft tant que la page n'est pas prête).
• Mettez à jour Dernière revue quand vous vérifiez une page.

Besoin d'aide ?

Si vous êtes bloqué, contactez l'équipe documentation — mais le parcours ci-dessus est conçu pour être autonome, sans assistance technique.