Organisation de la documentation
La documentation Lilia Digital est conçue pour évoluer sur 5 à 10 ans sans reconstruction. Elle suit une approche docs-as-code : tout le contenu est écrit en Markdown, versionné dans Git, et publié automatiquement. Aucune base de données, aucun outil propriétaire.
Une taxonomie à trois axes
Chaque page est classée selon trois axes, portés par son frontmatter :
1. Tier (audience)
Le tier détermine qui peut voir la page. Trois tiers existent :
| Tier | Audience | Visibilité |
|---|---|---|
public | Tout le monde | Ouverte, indexée par les moteurs |
client | Clients authentifiés | Réservée, derrière authentification |
internal | Équipe interne | Réservée, derrière authentification |
Les trois tiers sont servis en production. Le tier public est ouvert à tous ; les tiers
client et internal sont servis depuis des espaces séparés, derrière une authentification
déléguée. La séparation est physique : le contenu réservé n'est jamais compilé dans le site
public — aucun mélange n'est possible.
2. Univers (domaine)
L'univers situe la page dans un domaine produit : transverse (commun à tout l'écosystème),
puis, au fil de la fédération, les univers propres à chaque produit (site web, backend, etc.).
3. Catégorie (nature)
La catégorie décrit la nature du contenu : presentation, guide, reference, glossaire…
Le frontmatter, en pratique
Chaque page porte un en-tête normalisé. Exemple :
---
title: Titre de la page
description: Résumé court pour le SEO et les listes.
tier: public # public | client | internal
univers: transverse # domaine produit
categorie: guide # nature du contenu
owner: lilia-digital # responsable de la page
status: published # draft | review | published | deprecated
last_reviewed: 2026-06-28
---
Cette convention est stable : elle est posée dès le socle public pour accueillir, sans refonte, la fédération multi-univers et les tiers privés des phases suivantes.
Comment naviguer
- Le menu latéral liste les pages de l'espace courant.
- La recherche (en haut) interroge l'ensemble du contenu public.
- Le glossaire définit le vocabulaire clé.