25 lines
3 KiB
Markdown
25 lines
3 KiB
Markdown
# REF-DOCUMENTATION : comment on écrit et où (journal, registre, docs, fiches, nommage, traces)
|
|
|
|
Statut : **projet**. Produit par REF1-SPEC-01, 2026-10-15. Source : CSV CART (29 règles DOC). La charte 36 prime sur les anciens usages (pas de rétroactivité).
|
|
|
|
| Règle (reformulée) | Source (doc §) | Skill | ids |
|
|
|---|---|---|---|
|
|
| Livrables de lot : `Docs\Migration\etat\<projet>\<lot>\<LOT>-<TYPE>-<nn>.md`, gabarit de `lp-doc\gabarits.md` | 29 §Dépôts ; 36 §1-2 | lp-doc, lp-lot | C3-040, C3-076 |
|
|
| Journal, registre, index README, docs 01-32 et `correctifs\` sous `Docs\` (DOCMV, CHG-300) ; `etat\` de la copie 5.5 = archive figée sauf `etat\REPO` | 29 §Point d'étape | lp-doc | C3-040 |
|
|
| Fiche nommée `<LOT>-<TYPE>-<nn>`, TYPE ∈ CART, SPEC, IMPL, BUILD, VAL, DOC, RECH, PERF, INV | 36 §2 | lp-doc (texte proposé NOM1-TEXTES, non appliqué) | C3-077 |
|
|
| Tickets du gardien `<LOT>-T<n>` ; la lettre R n'est plus réutilisée | 36 §2 | sk-repo | C3-078 |
|
|
| Bases durables sous `etat\BASES\<BASE>\`, citées, jamais copiées ; BC/DOC/REFAC d'OPT restent en place | 36 §2-3 | lp-doc | C3-079 |
|
|
| Outils nouveaux nommés Verbe-Objet en français ; ancien nom indexé dans `Tools\LISEZMOI.md` | 36 §2-3 | — | C3-080 |
|
|
| Aucune rétroactivité sur les noms existants (CHG, ERR, tickets, assets) | 36 §2 | lp-doc | C3-080 |
|
|
| Numéros CHG, ERR, DOC réservés par `Tools\Numero.ps1` dans `etat\REPO\NUMEROS.md`, jamais « dernier + 1 » | 36 §1 | lp-repo, lp-doc | C3-076 |
|
|
| Une entrée CHG par modification (avec retour arrière) ; ERR au registre (ouvert, corrigé, accepté, préexistant) | 10 §5 | lp-doc | C1-067 |
|
|
| Entrée CHG écrite seulement quand son commit est imminent ; plage de l'index README dans le même commit | 32 §15.3 | lp-doc | C3-051 |
|
|
| Traces du gardien : statut du ticket et ligne de `REPO-JOURNAL.md` dans le même commit, sans hash | 32 §15.4 | lp-repo | C3-053 |
|
|
| Traces périssables : résumé dans `<LOT>-TRACES.csv` en FIN-LOT, passage mensuel vers `TRACES-INDEX.csv`, corbeille sur accord (`Traces.ps1`, `Corbeille.ps1`), jamais `rm` | 32 §15.12 | lp-doc | C3-062 |
|
|
| Compte rendu : section « Mesuré » en sorties brutes ; note de contexte par trace ; ligne « À verser » reprise par la DOC de clôture | 34 §3.2-3.4 | sk-protocol | C3-068 |
|
|
| Gabarits TPL1 : fiche au gabarit sk-orchestrate §3, registre `<LOT>-TACHES.md`, mesures par `FicheStats.py` | 29 §TPL1 | sk-orchestrate, lp-doc | C3-042 |
|
|
| Compteurs et chemins des docs anciens obsolètes : renvoyer au journal et au registre courants | 10 §5 | lp-doc | C1-069 |
|
|
| Les scripts d'état écrivent par `Tools\EtatDir.ps1` ; chaque reste à faire entre dans la liste unique des reports | 21 ; 03 §4 | lp-lot | C2-065, C1-015 |
|
|
| Chaque lot d'animations ou de coiffures : instantané, CHG, retour arrière par `Restore.ps1` | 20 §6 ; 14 | lp-lot | C2-053 |
|
|
| Descripteurs de mod (`.uplugin`, `.lpmod`, `pack.json`, README) sans source de vérité unique | 23 §3.4 | — | C2-077 |
|
|
| Renvois entre docs à tenir à jour (le doc 26 cite « doc 23 » pour le doc 25) | 26 | lp-doc | C3-007 |
|