Appearance
Cross-repository
Pages here describe how the repositories work together. Anything that belongs to a single repository goes in that repository's section under Repositories.
Overall architectureThe whole Ediky system on one page.Repository dependenciesWhich repository depends on which, and how.CommunicationThe protocols and contracts between repositories and services.Data flowHow data moves from where it's authored to where it's used.Shared componentsCode, config and conventions used by more than one repository.End-to-end flowsUser-visible journeys traced across every repository they touch.
Where things go
| If you're documenting… | Put it in |
|---|---|
| How one repository works inside | docs/repos/<repo>/architecture.md |
| A contract between two repositories | Communication |
| Something imported or copied by several repositories | Shared components |
| A user journey that crosses repositories | End-to-end flows |
Existing reference
These pages were written before this section existed and already cover parts of it: