Razgovor s Anom Kovač: kako se gradi dokumentacija koju nitko ne mrzi

Ana Kovač radila je kao tehnička pisac za tri SaaS startup-a između 2020. i 2023. godine, u okruženjima gdje se dokumentacija pisala uvijek „kad bude vremena” — što znači nikad dovoljno dobro. Razgovarali smo o tome što je naučila kroz taj proces. Prva stvar koju ističe je da loša dokumentacija nije problem lošeg pisanja — ona je problem lošeg prioritiziranja. „Kad tim ne zna tko je odgovoran za dokumentaciju, svi su i nitko. Developer napiše tehničke detalje koje razumije samo on, product manager doda marketing jezik koji ne odgovara na konkretna pitanja, i na kraju korisnik dobije stranicu koja izgleda kompletno, ali ne pomaže mu ništa.” Alati koje preporučuje nisu iznenađujući — Notion, Docusaurus, GitBook — ali ono što ih razlikuje od neuspješnih implementacija je disciplina oko strukture, ne oko formata. Svaki dio dokumentacije treba odgovoriti na jedno od četiri pitanja: što je to, kako se koristi, zašto se nešto ponaša ovako, ili što napraviti kad pođe krivo. „Kad znaš kojoj kategoriji tekst pripada, znate i kako ga pisati i kako ga nasloviti.” Za timove koji počinju od nule, njen savjet je kontra-intuitivan: počnite s FAQ-om, ne s getting started vodičem. Pitanja koja korisnici već postavljaju u podršci su najprecizniji mogući brief za dokumentaciju — i odmah imate metriku uspjeha.