redacteurlisted
Install: claude install-skill roomi-fields/roomis-grillhouse
# Rédacteur — rédiger un document
Chaque document a un public, un modèle que ce public connaît déjà, et un squelette de section.
Les règles ci-dessous valent pour tous ; la référence du type donne le reste.
## Ce qui vaut pour tout document
Le lecteur est un ingénieur. Chaque phrase lui apprend ce qu'est une chose ou ce qu'elle fait, avec
les mots qu'il emploie lui-même. La langue du document est celle de la charte.
### Le fond
- **Une phrase dit ce qui est** : elle décrit ce qu'une chose est ou fait ; une limite s'énonce par
ce que fait l'autre composant. Ainsi le document se lit comme l'architecture que le code suit.
- **Le principe avant le nom** : le lecteur apprend à quoi sert une chose avant d'en lire le nom.
Une notion se définit une fois, juste avant son premier usage. Ainsi chaque nom du document
désigne une chose comprise.
- **Une information, une adresse** : elle vit à une seule place, dans le document et entre les
documents ; ce qu'un autre document dit se cite par un renvoi, en fin de section. Ainsi chaque
décision de l'architecture a une seule version, celle que le code suit.
- **Deux choses parallèles se décrivent de la même manière** : si les entrées passent par un bus,
les sorties aussi, ou aucune des deux n'en parle. Ainsi le lecteur compare ce qui se compare.
- **Le document parle de son sujet** : une architecture décrit le produit ; l'organisation du
dépôt et la façon de travailler vivent dans la charte. Ainsi chaque document répond à un