Skip to main content

[DRAFT] ADR-010: Modular Documentation Approach

Context​

The WEP Digital Hub will likely grow into hundreds of pages. A flat structure or deep nesting with local assets can become unmanageable.

Proposed Decision​

Evaluate a modular approach where:

  1. Components (e.g., individual projects or systems) are treated as self-contained nodes.
  2. Shared logic (Guidelines, Templates) is centralized in 00-Meta.
  3. Assets are primarily stored in a central 03-Assets directory OR local img/ folders depending on the scope.

Expected Consequences​

  • Scalability: Easier to re-index and refactor individual modules.
  • Complexity: Requires sophisticated sidebar management in Docusaurus to maintain a clean UX.