40 lines
3.3 KiB
Markdown
40 lines
3.3 KiB
Markdown
<!-- file: README.md -->
|
|
<!-- version: 9 -->
|
|
|
|
# Project Governance Rules
|
|
|
|
Project Governance Rules (`PGR`) est un référentiel réutilisable de gouvernance, développement, validation et structuration de projets logiciels.
|
|
|
|
Son objectif est de normaliser ce qui mérite de l'être, de simplifier les workflows récurrents, d'automatiser les contrôles fiables et de conserver une traçabilité utile sans transformer la gouvernance en bureaucratie.
|
|
|
|
Le dépôt officiel est `https://git.sasedev.com/Sasedev/pgr`.
|
|
|
|
## Statut
|
|
|
|
PGR est actuellement en phase de fondation `0.0.x`.
|
|
|
|
La version courante est définie par [`VERSION`](VERSION). La release `0.0.1` établit la gouvernance normative et documentaire de PGR lui-même. La release `0.0.2` ajoute les premiers profils réutilisables Rust/Cargo, Java/Maven/Gradle et Android, ainsi que deux audits Markdown. La release `0.0.3` fournit les premiers modèles Rust/Cargo, deux audits de style Rust facultatifs, l'audit des headers Markdown et la spécification du message manuel de reprise. La série `0.0.x` se poursuit avec les spécifications de skeletons de `0.0.4`. Le contrat transversal et la première fondation de projet gouverné sont désormais matérialisés ; les spécialisations technologiques restent composables et séparées.
|
|
|
|
## Entrées principales
|
|
|
|
- [`RULES.md`](RULES.md) — point d'entrée normatif ;
|
|
- [`ROADMAP.md`](ROADMAP.md) — découpage macro des releases PGR ;
|
|
- [`CHANGELOG.md`](CHANGELOG.md) — changements des releases publiées ;
|
|
- [`docs/000-README.md`](docs/000-README.md) — index documentaire ;
|
|
- [`docs/objectives/001-PROJECT_OBJECTIVES.md`](docs/objectives/001-PROJECT_OBJECTIVES.md) — mission, objectifs et non-objectifs ;
|
|
- [`docs/architecture/001-PROJECT_PROFILE.md`](docs/architecture/001-PROJECT_PROFILE.md) — profil applicable au dépôt PGR ;
|
|
- [`docs/architecture/002-GOVERNANCE_ARCHITECTURE.md`](docs/architecture/002-GOVERNANCE_ARCHITECTURE.md) — architecture du référentiel ;
|
|
- [`docs/plans/001-V0_0_1_FOUNDATION_PLAN.md`](docs/plans/001-V0_0_1_FOUNDATION_PLAN.md) — plan historique de fondation `0.0.1` ;
|
|
- [`docs/plans/002-V0_0_2_RULE_PROFILES_PLAN.md`](docs/plans/002-V0_0_2_RULE_PROFILES_PLAN.md) — plan historique des premiers profils `0.0.2` ;
|
|
- [`docs/plans/003-V0_0_3_TEMPLATES_AUDITS_PLAN.md`](docs/plans/003-V0_0_3_TEMPLATES_AUDITS_PLAN.md) — plan historique des templates et audits `0.0.3` ;
|
|
- [`docs/plans/004-V0_0_4_SKELETONS_PLAN.md`](docs/plans/004-V0_0_4_SKELETONS_PLAN.md) — plan actif des skeleton specifications `0.0.4` ;
|
|
- [`docs/skeletons/000-README.md`](docs/skeletons/000-README.md) — index des skeleton specifications et de leur contrat de composition ;
|
|
- [`docs/skeletons/001-PROJECT_GOVERNANCE_FOUNDATION.md`](docs/skeletons/001-PROJECT_GOVERNANCE_FOUNDATION.md) — fondation composable de gouvernance locale pour un projet adoptant PGR ;
|
|
- [`docs/validation/001-VALIDATION_MATRIX.md`](docs/validation/001-VALIDATION_MATRIX.md) — matrice de validation.
|
|
|
|
## Langue et nomenclature
|
|
|
|
Les noms de fichiers, répertoires, identifiants, code et configurations utilisent l'anglais. Les explications et la documentation normative du dépôt principal utilisent le français.
|
|
|
|
Une éventuelle traduction complète de PGR doit vivre dans un dépôt séparé, par exemple `pgr-en`, `pgr-de` ou `pgr-ar`, et non dans une arborescence multilingue du dépôt principal.
|