Suite handbook

This handbook describes how the Courseforge and related jmjava repositories fit together: responsibilities, documentation flow, and where to regenerate narrated video docs with docgen.

Sources for this section (Markdown, PlantUML, and the rendered diagram below) live in jmjava/documentation-generator under docs/suite/. They are synced into this site whenever courseforge/infrastructure runs Publish GitHub Pages.

Repository relationships

Diagram source: docs/suite/diagrams/suite-relationships.puml in documentation-generator. To regenerate PNGs locally or in CI, use ./scripts/render-suite-diagrams.sh (requires Java and Graphviz dot; vendored JAR under third_party/plantuml/; see .github/workflows/render-suite-diagrams.yml).

Where to read next

• Suite architecture — narrative architecture page on this site.
• Repositories — quick links to every workspace repo and its role.
• Regenerating documentation (docgen) — CLI recap and per-repo status.
• Documentation / video index — aggregated docgen renders (docs/rendered/ from each product repo).

Suite integration (deep dive)

The orchestration repo’s Phase 1 trigger graph and workflows are documented in docs/suite-integration.md.