C4 werkt omdat het start bij de buitenkant (system context) en alleen detailleert waar dat helpt. Een architect kiest welke containers en componenten u uittekent en welke u oversla.
Welke vier niveaus zijn relevant?
System context voor stakeholders, container voor ontwikkelteams, component voor specifiek complexe modules en code als laatste optie. De meeste organisaties komen met de eerste twee al ver.
Wat documenteert u en wat niet?
Wat afwijkt van de standaard en wat een nieuwe ontwikkelaar binnen een week moet begrijpen. De rest is overhead.
Welke tooling past?
Structurizr DSL, PlantUML of Mermaid in Markdown. Door diagrammen als code te beheren blijft de documentatie dichtbij de codebase en is zij makkelijker actueel te houden.
Wie zetten wij in?
Een architect die C4 ergens in productie heeft toegepast en uw team begeleidt bij het bijhouden van de modellen.
Verwant: Freelance Applicatie Architect