Sasedev/khadhroony-bot3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v0.1.0-pre.066

Browse Source
This commit is contained in:
SinuS von SifriduS
2026-07-31 07:23:36 +02:00
parent 0befb170c7
commit 06fddf63b3
14 changed files with 70 additions and 50 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
docs/DOCUMENTATION_REFACTOR_AUDIT.md
View File

@@ -1,5 +1,5 @@
<!-- file: docs/DOCUMENTATION_REFACTOR_AUDIT.md -->
<!-- version: 3 -->
<!-- version: 4 -->
# Audit de refonte documentaire
@@ -19,9 +19,9 @@ Les fichiers suivants existent à la racine :
- `CHANGELOG.md` ;
- `ROADMAP.md` ;
- `RULES.md` ;
- `RULES_GENERAL.md` ;
- `RULES_RUST.md` ;
- `RULES_SPECIFIC_KHADHROONY.md` ;
- `docs/rules/RULES_GENERAL.md` ;
- `docs/rules/RULES_RUST.md` ;
- `docs/rules/RULES_SPECIFIC_KHADHROONY.md` ;
- `KHADHROONY_BOT3_MIGRATION_CLOSURE_TODO.md`.
### 2.2 Documentation active bot3
@@ -123,7 +123,7 @@ Le workspace déclare 11 crates :
Aucune crate ne satisfait donc le contrat complet `README.md`, `TODO.md`, `USAGE.md`, `CHANGELOG.md`.
Une contradiction normative existe dans `RULES_GENERAL.md` : le fichier exige encore un `README.md` ou `001.README.md` et, à terme, un `USAGES.md`. La convention retenue est `USAGE.md`, nom singulier couramment utilisé pour un guide d’utilisation. La règle doit imposer exactement `README.md`, `TODO.md`, `USAGE.md` et `CHANGELOG.md`.
La contradiction `USAGES.md` contre `USAGE.md` est résolue en faveur de `USAGE.md`. `001.README.md` reste autorisé uniquement comme index lexical de répertoire très fourni, notamment sous `idls/`, et ne remplace jamais le `README.md` obligatoire d’une crate.
### 4.4 Frontière de l’archive documentaire
@@ -162,8 +162,8 @@ Le déplacement des règles secondaires vers `docs/rules/` ne doit pas être eff
Références actives identifiées :
- `RULES.md` lie directement les trois fichiers secondaires à la racine ;
- `RULES_GENERAL.md` cite leurs chemins racine et le contrat documentaire obsolète `USAGES.md` ;
- `RULES_SPECIFIC_KHADHROONY.md` lie `RULES_GENERAL.md` et `RULES_RUST.md` par chemins relatifs racine ;
- les scripts, prompts et documents actifs doivent employer les chemins `docs/rules/...` ;
- `docs/rules/RULES_SPECIFIC_KHADHROONY.md` lie `docs/rules/RULES_GENERAL.md` et `docs/rules/RULES_RUST.md` par chemins relatifs racine ;
- `scripts/audit_khadhroony_workspace_rules.py` vérifie explicitement les quatre chemins racine à deux endroits ;
- les deux prompts bot3 citent les chemins racine ;
- `KHADHROONY_BOT3_MIGRATION_CLOSURE_TODO.md` décrit l’organisation actuelle.