3 KiB
3 KiB
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 |