Séria: Ako písať dokumentáciu a manuály v IT projekte
V prvom článku série „Nie je manuál ako manuál“ som pomenovala problém miešania cieľových skupín v dokumentácii.
Dnes sa posunieme o krok ďalej.
Čo sa deje vo firmách, kde dokumentácia neexistuje vôbec?
Reálny problém z praxe
Príde nový kolega.
Opýta sa:
„Kde je k tomu dokumentácia?“
Odpoveď:
„Spýtaj sa Petra, on to robil.“
Peter je vyťažený.
Support čaká.
Projekt stojí.
Funkcionalita existuje.
Systém funguje.
Dokumentácia nie.
A firma si myslí, že to nie je zásadný problém.
Veď sa to dá vysvetliť.
Čo sa tu vlastne pokazilo (analýza systému)
Absencia dokumentácie nie je komunikačný problém.
Je to systémový problém.
Keď dokumentácia neexistuje:
- znalosti sú v hlavách jednotlivcov,
- rozhodnutia nie sú dohľadateľné,
- custom úpravy nie sú oddelené od Core,
- incidenty sa vyriešia, ale nezapíšu,
- onboarding prebieha cez improvizáciu.
To nie je agilita.
To je krehký systém.
Ako to vyzerá v realite
1️⃣ Závislosť na senioroch
Každá otázka ide za rovnakým človekom.
Ak je na dovolenke, firma čaká.
Vzniká jednobodové zlyhanie – nie v infraštruktúre, ale v znalostiach.
2️⃣ Falošné bugy
Tester vidí správanie, ktoré nikde nie je popísané.
Je to:
- bug?
- feature?
- klientská výnimka?
- historický workaround?
Bez dokumentácie sa testovanie mení na hádanie.
Konflikty medzi testom a vývojom nie sú osobné.
Sú systémové.
3️⃣ Chaos v Core vs Custom
Klient XY má špeciálny workflow.
Nikto si nepamätá, že je to custom riešenie.
Support to začne považovať za štandard.
Nový klient to očakáva.
Vývojár to upraví a rozbije Core.
Bez dokumentácie sa produkt rozpadá na výnimky.
A firma si často nevšimne moment, keď prestane byť produktom a stane sa sériou zákaziek.
4️⃣ Incidenty bez učenia
Príde produkčný problém.
Tím ho vyrieši.
A ide sa ďalej.
Nikto nezapíše:
- symptóm,
- príčinu,
- riešenie,
- prevenciu.
O mesiac sa incident zopakuje.
To nie je smola.
To je chýbajúca znalostná báza.
5️⃣ Onboarding ako skúška prežitia
Nový tester alebo support človek nemá:
- mapu systému,
- architektúru,
- oddelené Core vs Custom,
- historický kontext.
Učí sa cez chyby.
To je drahé.
Časovo aj reputačne.
Skutočné náklady (ktoré nie sú viditeľné)
Absencia dokumentácie spôsobuje:
- pomalšie testovanie,
- viac tiketov,
- vyššiu záťaž seniorov,
- riziko pri odchode kľúčového človeka,
- slabú pripravenosť na AI a automatizáciu,
- obmedzené škálovanie firmy.
Nikto to nenazve „incident dokumentácie“.
Ale dopad je reálny.
Minimálny model riešenia
Začína sa to disciplínou, nie 200-stranovým manuálom.
1️⃣ Každá nová funkcionalita má:
- špecifikáciu,
- akceptačné kritériá,
- jasné označenie Core vs Custom.
2️⃣ Každý incident sa zapisuje:
- symptóm,
- príčina,
- riešenie,
- dopad.
3️⃣ Dokumentácia je súčasť Definition of Done.
Ak je feature hotová, ale dokumentácia nie je aktualizovaná, nie je hotová.
Prepojenie na kvalitu a workflow
V tejto sérii postupne ukazujem, že dokumentácia nie je administratíva.
Je to kontrolný mechanizmus kvality.
Ak sa podľa dokumentácie nedá:
- otestovať funkcionalita,
- nasadiť verzia,
- vyriešiť incident,
- onboardovať nový kolega,
tak dokumentácia neexistuje — aj keď je uložená v nástroji.
Krátke zhrnutie
Vo firmách bez dokumentácie vzniká:
- závislosť na senioroch,
- falošné bugy,
- miešanie Core a Custom,
- opakujúce sa incidenty,
- spomalený onboarding.
To nie je kultúrny problém.
To je architektúra projektu.