BrightWeb Platform Docs

This docs/ folder is the single source of truth for BrightWeb documentation.

• Humans should be able to read it directly in the repo.
• The dev-docs app renders the same files online.
• Agents should read and update docs here, not in apps/dev-docs/app/docs.

Fast map

• Start at Foundations
• Then read Modules
• Then use Architecture reference and Operations reference as needed
• Treat this file as the docs index for both humans and agents

Sections

• Foundations
• Modules
• Architecture reference
• Operations reference
• Recipes

Recommended read order

1. Foundations
2. Modules
3. Architecture reference
4. Operations reference
5. Recipes

How this repo should use docs

1. Put durable product, architecture, and operations knowledge in docs/.
2. Keep app-only documentation logic out of apps/dev-docs when possible.
3. Treat the docs app as a presentation layer over this folder, not a separate content system.