5 pravidel, jak psát technické texty, které inženýři dočtou

Struktura, která respektuje způsob čtení Technický čtenář obvykle neskroluje od začátku do konce. Skenuje nadpisy, hledá klíčová slova, odstavce přeskočí, pokud nemají jasný obsah. Proto pište tak, aby každý nadpis nesl konkrétní tvrzení, ne jen kategorii. Místo „Vlastnosti" použijte „Kompatibilita se staršími zařízeními". Místo „Výhody" napište „Co se zkrátí při nasazení". Krátké odstavce o dvou až čtyřech větách drží čtenáře v orientaci a snižují riziko, že se v textu ztratí.

Praktický postup je jednoduchý. Napište si vlastní osnovu a klíčové body. Teprve pak je vložte do nástroje a nechte ho vytvořit koncept. Ten projděte a přepište vlastními slovy. Bezplatné nástroje často nejlépe fungují jako startér, ne jako finišer. Když je použijete na prvotní návrh a pak text doladíte sami, ušetříte čas a zachováte si vlastní hlas. Naopak odevzdat surový výstup je cesta k tomu, že text bude zaměnitelný s kterýmkoli jiným.

Čtvrtý krok je ověření faktů. Stroj umí plynule vygenerovat tvrzení, které zní přesvědčivě, ale je věcně špatné, smíchané z více zdrojů, nebo připisuje citát někomu, kdo ho nikdy neřekl. Zkuste si vytipovat dvě nebo tři konkrétní informace a dohledat je jinde. Pokud se rozcházejí s tím, co text tvrdí, je to silný signál. Pozor ale na opačný omyl: i lidský autor se může splést nebo vycházet ze zastaralého zdroje.

U opakujících se formátů, jako jsou novinky, rozbory nebo odpovědi na dotazy, se vyplatí mít šablonu pro každý zvlášť. Jeden univerzální vzor nutí cpát stejnou strukturu do textů, které ji nepotřebují. Oddělené šablony zaberou jedno odpoledne a pak už jen doplňujete. Hlídejte si ale, aby se šablona nezačala rozrůstat – jakmile má víc oddílů než samotný text, je čas ji zkrátit.

Praktický postup je jednoduchý. Odpověď si rozdělíte na dvě části: na to, co chcete zachovat beze změny, a na to, co je jen kontext. Kontext si opište vlastními slovy ve dvou až třech větách. Tím si ověříte, že rozumíte tomu, co model vlastně tvrdí. Když to nedokážete přeformulovat, pravděpodobně to ani nebudete umět použít později.

Výstupy z jazykových modelů mají jednu nepříjemnou vlastnost: jsou skvělé v okamžiku, kdy je vytvoříte, a beznadějně ztracené, jakmile zavřete okno. Přitom právě ty nejlepší nápady, návrhy textů nebo třeba přehledy často vznikají mimochodem při ladění něčeho úplně jiného. Aby se z hodnotné odpovědi nestal jen dočasný text v paměti, je potřeba ji uložit dřív, než ji zapomenete. Nestačí označit text a zmáčknout Ctrl+C. Opravdové pozdější použití začíná u místa, kam výstup uložíte.

Technický čtenář nečte texty jako běžný návštěvník webu. Nemá trpělivost na omáčky, nevěří superlativům a většinou přesně ví, co hledá. Pokud mu předložíte odstavec plný marketingových frází, zavře stránku dřív, než se dostanete k pointě. Rozdíl mezi textem, který technika zaujme, a textem, který ho odradí, není v délce ani v barvách. Je v tom, jak rychle a přesně mu dáte informaci, kterou potřebuje k rozhodnutí.

Nástroje AI na psaní reklamních textů vypadají na první pohled jako zkratka k hotovému výsledku. V praxi ale většina výstupů skončí v koši, protože působí jako přeložený katalog. Rozdíl mezi použitelným a nepoužitelným textem není v tom, který nástroj si vyberete, ale jak ho vedete. Model bez kontextu napíše obecné fráze o kvalitě a výhodách. Když mu dáte konkrétní zadání, může dodat použitelný základ.

Vyhněte se typickým chybám, které techniky spolehlivě odradí. Patří mezi ně úvodní odstavce o tom, jak je dnešní doba dynamická, nejasné sliby bez zdroje, zaměňování pojmů (například přesnost versus opakovatelnost) a věty, které znějí odborně, ale nic neříkají. Další častou chybou je skrývání nevýhod. Technik ocení, když text přizná omezení: za jakých podmínek řešení nefunguje, kde má slabinu, co je potřeba doplnit. Důvěra vzniká z přesnosti, ne z dokonalosti.

Ukládejte vždy i zadání, které k výstupu vedlo. Bez něj si za půl roku nebudete jistí, jestli model odpovídal na přesnou otázku, nebo na něco jiného. Zadání stačí zkrátit na jednu nebo dvě věty a přilepit ho nad samotný výstup. Když budete chtít výsledek později rozšířit nebo opravit, budete mít od čeho se odrazit. Tento krok zabere pár sekund a zachrání spoustu času.

Nakonec počítejte s tím, že výstup z AI není hotový text. Je to polotovar. Před použitím ho vždy projděte, ověřte fakta a upravte tón podle toho, komu je určený. Pokud ho jen uložíte a později bez kontroly odešlete dál, riskujete, že se do vaší práce dostanou chyby, které model vyrobil. Ukládání má smysl jen tehdy, když k uloženému materiálu přidáte i vlastní úsudek.