Documentation Architecture Review¶

Purpose¶

This document tracks the architecture review of the CMonChoix Platform documentation.

The goal is not to rewrite the documentation from scratch.

The goal is to transform the existing docs/ directory into a governed, scalable, industrial documentation system.

docs/architecture/dependances.md and docs/architecture/identifier-first.md currently contain identical content.

Decision required:

keep dependances.md as the dependency document;
rewrite identifier-first.md as the official Identifier First architecture document.

docs/governance.md and docs/governance/index.md must keep distinct responsibilities:

docs/governance.md defines stable governance rules;
docs/governance/index.md is the entry point for detailed Governance documents.

ADR documents currently exist in multiple locations:

Decision required:

Several overview.md files are too small to act as proper entry points.

Each overview should define:

Several documents contain only placeholder-level content.

Decision required:

Some documents still mix Platform architecture with WordPress/plugin concerns.

Each document will be classified as one of:

No document is deleted without audit, replacement, or explicit archival decision.

Build a complete document inventory with classification, priority, and remediation action.