V mnoha společnostech dokumentace ve skutečnosti znamená stovky až tisíce samostatných souborů:

• na sdílených úložištích
• v e-mailech
• v komunikačních kanálech
• jinde než by měli být

Jednotlivé týmy si vytvářejí vlastní verzi pravdy, která se může diametrálně lišit a vyžaduje samostatnou údržbu.

Verzovaný chaos.

Maddocs je reakce na situaci:
odstranit duplicity a sjednotit dokumentaci. Vnést do chaosu pořádek a řád.

Dokumentace jako systém:
ne vedlejší produkt, ale součást architektury.

Maddocs pracuje se základní entitou každého enterprise projektu: business požadavkem. Ten ale nekončí okamžikem splnění. Prochází celým životním cyklem projektu a v každé fázi mění svou podobu. Končí jako vždy aktuální a smysluplná dokumentace:

• pro zadavatele je to požadavek
• pro business proces
• pro vývojáře objekt
• pro testera funkcionalita
• pro uživatele use case

Nejde o různé artefakty, ale o jednu a tutéž entitu nahlíženou z různých perspektiv. Přechod mezi fázemi není skok ani přepis, ale přirozená transformace. Maddocs tento kontinuální vývoj zachovává, propojuje a udržuje v jednom konzistentním modelu.

Maddocs není dokumentační nástroj, wiki ani ticketovací systém:
Neřeší jednotlivé soubory, ale stav poznání projektu jako celku. Největší přínos má tam, kde se projekty dlouhodobě vyvíjejí, předávají mezi týmy, podléhají regulacím nebo auditům a kde se informace nesmí ztrácet s lidmi.

Výstupem Maddocs jsou cílené pohledy na tentýž zdroj pravdy:
Z jednoho konzistentního základu vznikají různé dokumenty určené pro různé role a účely. Každý z nich je vždy aktuální, protože nevzniká kopírováním ani ruční údržbou, ale řízenou transformací obsahu.

Obsah se vždy podřizuje účelu:
Každá role dostává jen ty informace, které jsou pro ni relevantní v daném kontextu. Zadavatel vidí rozsah a smysl požadavku, business tok a dopady, vývoj technickou strukturu, tester ověřitelné chování a uživatel konkrétní scénáře použití. Nikdo není zatěžován informacemi, které pro jeho rozhodování nemají hodnotu.

Dokumenty tak nepředstavují statické artefakty:
Jsou to přesné a účelové řezy nad jedním modelem. Stejný obsah může sloužit pro návrh, realizaci, testování, audit i dlouhodobou údržbu, aniž by se rozpadal na paralelní verze.

Maddocs zajišťuje:
Každý pracuje s pravdou odpovídající jeho roli, bez šumu, bez duplicit a bez rizika, že se rozhoduje nad neaktuálními daty.

Maddocs se v tuto chvíli nachází ve fázi analýzy a vývoje prvního funkčního modulu. Cílem této etapy je ověřit základní principy systému v praxi, stabilizovat datový model a potvrdit, že řízená transformace dokumentace může dlouhodobě fungovat v reálném enterprise prostředí. Další rozšiřování bude navazovat na ověřený a funkční základ, nikoli jen na předpoklady.