0.1.0-0-pre.1
This commit is contained in:
37
docs/rules/RULES_GENERAL.md
Normal file
37
docs/rules/RULES_GENERAL.md
Normal file
@@ -0,0 +1,37 @@
|
||||
<!-- file: docs/rules/RULES_GENERAL.md -->
|
||||
<!-- version: 1 -->
|
||||
|
||||
# Règles générales du projet
|
||||
|
||||
## Portée
|
||||
|
||||
Les règles `GEN-*` s'appliquent à l'ensemble du dépôt.
|
||||
|
||||
## Hiérarchie normative
|
||||
|
||||
- **GEN-RULE-001** — `RULES.md` est l'index normatif racine et ne duplique pas les règles détaillées.
|
||||
- **GEN-RULE-002** — Les règles sont cumulatives.
|
||||
- **GEN-RULE-003** — Toute exception est locale, bornée, justifiée et traçable.
|
||||
- **GEN-RULE-004** — Une décision non validée reste une question ouverte et n'est pas transformée en règle par supposition.
|
||||
- **GEN-RULE-005** — Une validation n'est déclarée réussie que si elle a réellement été exécutée.
|
||||
|
||||
## Noms et fichiers texte
|
||||
|
||||
- **GEN-FILE-001** — Les noms de fichiers et répertoires sont en anglais, sans accent ni espace, sauf contrainte externe.
|
||||
- **GEN-FILE-002** — Tout fichier texte qui supporte les commentaires commence par son chemin relatif puis par une version entière de fichier.
|
||||
- **GEN-FILE-003** — Pour un script avec shebang, le shebang reste en première ligne et les métadonnées suivent immédiatement.
|
||||
- **GEN-FILE-004** — La version interne d'un fichier augmente à chaque enregistrement modifiant son contenu et ne diminue jamais.
|
||||
- **GEN-FILE-005** — Les fichiers texte se terminent par exactement une fin de ligne lorsque leur format le permet.
|
||||
|
||||
## Langues
|
||||
|
||||
- **GEN-LANG-001** — Code, identifiants, commentaires de code et rustdocs sont en anglais.
|
||||
- **GEN-LANG-002** — La documentation Markdown interne est rédigée en français, sauf nécessité externe explicite.
|
||||
|
||||
## Travail et validation
|
||||
|
||||
- **GEN-WORK-001** — Une tranche de travail traite un périmètre cohérent et validable.
|
||||
- **GEN-WORK-002** — Une tranche planifiée comme trop volumineuse doit être découpée avant exécution.
|
||||
- **GEN-WORK-003** — Une erreur introduite par une tranche est corrigée dans cette tranche ou explicitement reportée.
|
||||
- **GEN-WORK-004** — Une erreur métier ou architecturale n'est pas masquée par une exception globale de lint ou de test.
|
||||
- **GEN-WORK-005** — Les audits du dépôt sont en lecture seule sur les fichiers contrôlés.
|
||||
Reference in New Issue
Block a user