Daniel Allaire
aab1bcc83a
README reduit au role du projet et au demarrage rapide. docs/architecture.md (schemas Mermaid), docs/setup.md, docs/usage.md (154 cibles en 13 familles), docs/README.md (index). Documents ranges en conception/, exploitation/, hebergement/, projet/ ; 598 chemins suivis. QUICKSTART.md, SOLUTION.md, architecture-set-ops.md et la carte fondus puis retires. Preuves : P48 lit l'index et conception/mecanismes.md ; les gardes parcourent docs/ sous- dossiers compris (_documents) ; usage.md suit le Makefile dans les deux sens. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
6.1 KiB
Les pages publiées — où elles sont, et ce qu'elles montrent
Pour qui : le mainteneur, quand il cherche une page existante ou qu'il en écrit une neuve. Les pages elles-mêmes visent d'autres lecteurs — ce tableau le dit pour chacune.
Ce fichier est la liste entière, pas seulement celle de la série des flux. Une page publiée qui n'y figure pas est une page qu'on ne retrouvera pas : elle vit sur une adresse que personne ne devine, et elle vieillira sans que quiconque s'en aperçoive.
La série des flux, elle, obéit à une règle propre : ces pages expliquent comment les
choses sont configurées et interconnectées. Ce ne sont pas des comptes rendus — elles ne
relatent aucun incident, ne datent aucune panne et ne comptent aucune machine tombée. Ce
travail-là appartient au CHANGELOG.md et à docs/projet/decisions-architecture.md. Une page de
cette série répond à une seule question : par où passe telle chose, et pourquoi par là.
La série
| # | Page | Ce qu'elle montre |
|---|---|---|
| 1 | La chaîne de l'heure | Du satellite aux machines par la frontière — une seule sortie |
| 2 | La vie d'un certificat | Racine, émission, renouvellement, consommateurs, contrôle |
| 3 | Comment un nom devient une adresse | Le plancher, le résolveur, l'autoritatif — dans cet ordre |
| 4 | D'où vient un paquet | Le cache, ses deux faces, et les deux langues d'apt |
| 5 | Une identité, un mot de passe | L'annuaire, la fédération, la passerelle — et qui a droit à quoi |
| 6 | Ce qu'on ne peut pas refaire | La sauvegarde : ce qui part, ce qui ne part pas, qui vérifie |
| 7 | Trois canaux, trois sens | Verdicts poussés, chiffres tirés, journaux expédiés |
| 8 | Le trajet d'un courriel | Deux machines, un annuaire, une remise vérifiée |
Ce qui les relie
| Page | Ce qu'elle montre |
|---|---|
| Ce qui relie un locataire à son site | Les six liens de la filiation, et ce que coupe chacun |
Pages destinées à quelqu'un d'autre que le mainteneur
Registre différent : pas de nom de logiciel en titre, pas de vocabulaire de doctrine.
| Page | Pour qui |
|---|---|
| La maison TechnoLibre | Le propriétaire d'un écosystème — ce qu'il ouvre, où sont ses affaires |
| Où commence le système | Positionnement face à Coolify et Cloud in a Bottle |
| Deux sites, un tunnel | Plan de niveau 3 des deux sites reliés |
| Un écosystème Set-OPS | Article promotionnel — résultat et capacités |
| Inventaire libre | La liste des logiciels libres de la solution |
La page commerciale
Une seule page en quatre parties — le moteur, les offres, les tarifs, la valeur. C'est la seule qui affirme un état (« éprouvé ») et un prix ; elle se relit donc chaque fois qu'une capacité change de camp.
| Page | Ce qu'elle porte |
|---|---|
| Capacités, offres, tarifs et valeur | Dix piliers, huit offres, la grille tarifaire, le calculateur et les réserves |
Les chiffres qu'elle avance se mesurent : nombre de rôles, de preuves, d'affirmations au registre, de lignes de documentation. Les recompter avant de republier, plutôt que de les reconduire.
Plus anciennes, gardées pour mémoire
Elles n'ont pas été revues depuis leur publication et peuvent décrire un état dépassé.
| Page | Ce qu'elle montrait | Publiée |
|---|---|---|
| Plan, dérivation, preuve | La méthode du moteur, en une page | 2026-08-26 |
| Préparer ton site pour TechnoLibre | La préparation du site d'un partenaire | 2026-08-12 |
| Réseau Chezlepro — les trois plans | Les trois plans du réseau, avant la fusion du lien de sortie | 2026-08-04 |
La règle d'écriture
Garder le mécanisme et sa raison. Retirer l'anecdote, la date, la durée, le nombre de machines touchées.
Un réglage mérite souvent son explication — harden-below-nxdomain: no n'a aucun sens sans
savoir que la racine signée nie le domaine internal.. Ça reste. Ce qui ne reste pas, c'est
combien de temps il a fallu pour le comprendre.
Les chiffres sont admis quand ils donnent un ordre de grandeur utile (« un écosystème de quatorze machines demande environ 1,3 Go de paquets »), pas quand ils racontent une soirée particulière.
Quand les relire
Une page décrit une configuration : elle vieillit quand la configuration change. Les points à revérifier après une modification d'architecture sont, dans l'ordre :
- un service prêté ajouté ou retiré → pages 4, 6 et celle des liens
- un renumérotage → toutes les pages qui portent une adresse
- une bascule (résolveur, cache, sauvegarde) → pages 3, 4, 6
- un rôle neuf avec une sonde → page 7
- une capacité qui passe de la feuille de route au service → la page commerciale, où elle porte un badge d'état et parfois un prix. C'est la relecture la plus facile à oublier, parce qu'une bonne nouvelle ne ressemble pas à une tâche.