Daniel Allaire
ab0e74d843
Neuf pages expliquent comment les choses sont configurees et interconnectees. Leurs adresses n existaient nulle part dans le genome : elles vivaient dans une conversation. L index les range en trois familles — la serie des huit flux, la page qui les relie (la filiation), et celles qui visent quelqu un d autre que le mainteneur. LA REGLE D ECRITURE Y EST ENONCEE, parce que c est elle qui manquait : garder le mecanisme et sa raison, retirer l anecdote, la date, la duree, le nombre de machines touchees. Un schema sert a voir comment c est branche ; relater un incident est le travail du CHANGELOG et du registre des decisions. Les chiffres restent admis quand ils donnent un ordre de grandeur utile, pas quand ils racontent une soiree particuliere. Une derniere section dit QUAND les relire : un service prete ajoute ou retire, un renumerotage, une bascule, un role neuf avec une sonde. Carte d orientation : 40 -> 41 documents. P34 a exige que ce document declare son lecteur, comme tous les autres. make prouver : 72 OK, 0 echec, 1 saute. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Crgis8CxCWkAGFA1ecBz3q
4.2 KiB
Les schémas de flux — où ils sont, et ce qu'ils 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.
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/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 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