AI v praxi¶

AI nástroje používám seriózně pět let. Ne experimentálně — pracovně. Rozdíl je podstatný.

Co se změnilo¶

Po většinu mé kariéry byl úzkým hrdlem dokumentace čas. Věděl jsem, co je třeba napsat. Měl jsem strukturu v hlavě. Produkovat skutečný text v kvalitě, jakou jsem chtěl, trvalo déle, než projekt dovoloval. Dokumentace se proto škrtala, komprimovala nebo delegovala na někoho, kdo systému nerozuměl dost dobře, aby ji napsal přesně.

AI tento úzký hrdlo odstranil. Ne tím, že by psal za mě — tím, že odstranil tření mezi myšlením a textem. Já dodávám architekturu, zdrojový materiál, redakční úsudek. AI dodává rychlost.

Výsledek, v konkrétních číslech: dokumentační stack libdrone — hlavní specifikace, soubor proměnných, Payload SDK, hardwarový dokument, FreeCAD cookbook, nákupní seznam, návody k sestavení — vytvořený jedním člověkem, večery a víkendy, za 300 EUR v API nákladech. Na standardu, kterého bych sám v dostupném čase nedosáhl.

Jak to skutečně používám¶

Nejprve architektura. Navrhnu strukturu dokumentu předtím, než napíšu slovo. Co jsou sekce, co každá sekce zodpovídá, co je jediný zdroj pravdy pro každou hodnotu. Toto AI nenavrhuje. Dělám to já.

Zdrojový materiál dovnitř, strukturovaný text ven. Zadávám technická fakta — rozměry, specifikace komponent, kroky procesu — a dostávám prózu, kterou pak edituju. Editace je zásadní. AI text bez redakčního úsudku je rozpoznatelný a nepřesvědčivý.

Vynucení konzistence. Stack 40 dokumentů se stovkami křížových odkazů je redakční problém. AI je velmi dobrý v kontrole konzistence, hledání rozporů a označování míst, kde se hodnota objevuje na dvou místech s různými čísly.

Disciplína souboru proměnných. Každá číselná hodnota v dokumentaci libdrone žije v jednom souboru. Každý jiný dokument odkazuje na název proměnné, ne na hodnotu. Když se něco změní, změníte jeden soubor. Toto není AI technika — je to redakční technika, kterou jsem přinesl ze světa časopisů a aplikoval na technickou dokumentaci.

Co AI nedělá¶

AI neví, kdy je něco špatně. Produkuje věrohodný text. Věrohodný není totéž co přesný. Každé faktické tvrzení v každém dokumentu, který vytvářím, je ověřeno oproti primárnímu zdroji — hardwaru, měření, datasheetu. AI píše rychle. Vše kontroluji já.

AI nemá vkus. Neví, že věta je technicky správná, ale zmátne čtenáře, který přijde bez kontextu. Tento úsudek je redakční. To je to, co přináším já.

Kde stojím¶

Lidé, kteří jsou nervózní z AI ve svém oboru, jsou z velké části nervózní ze špatné věci. Nenahrazuje redakční úsudek. Nenahrazuje porozumění oboru. Nenahrazuje schopnost navrhnout dokumentační architekturu, která skutečně slouží člověku, který ji potřebuje.

Co nahrazuje, je výmluva, že dobrá dokumentace trvá příliš dlouho. Už netrvá. Což znamená, že jediný zbývající důvod pro špatnou dokumentaci je, že nikomu záleželo na jejím správném navržení.