Kontrolní vrstvy

Nástroj, který vám řekne, co neví

Napsat technickou zprávu umí dnes leccos. Těžší je nenapsat něco, co není pravda. Tahle stránka popisuje, co se s vaší dokumentací děje mezi „vygenerováno“ a „ke stažení“ — a proč někdy záměrně nedostanete zelené razítko.

Tři verdikty, ne jeden

Každý běh končí jedním ze tří stavů. Není to hodnocení kvality textu — je to odpověď na otázku, jestli systém dokáže obhájit všechno, co napsal.

Ověřeno

Všechna tvrzení mají oporu v zadání nebo v deterministickém výpočtu a žádná kontrola nenašla rozpor. Dokument jde k vaší autorizaci.

K revizi

Dokument je hotový, ale nese místa, o kterých musí rozhodnout člověk. Dostanete jejich seznam s odkazem na místo v textu. Ve Wordu je nahoře napsáno, že jde o pracovní verzi.

Blokováno

Něco je špatně natolik, že se výstup nevydá. Řekneme proč, kde to drhlo a co s tím — a dokumentaci nejde stáhnout bez výslovného varování.

Ty tři cesty existují schválně. Kdyby byla jen jedna, nikdy byste se nedozvěděli, že si systém není jistý — a právě to je informace, kvůli které se dokumentace kontroluje.

Co se prověřuje

Kontrol je 16 a jsou na sobě nezávislé. Část běží ještě před generováním nad zadáním, část nad hotovým textem, poslední rozhoduje o verdiktu.

K tomu jde hotový text ještě na nezávislé posouzení druhým modelem a nálezy vyhodnotí arbitr. Opravovat se smí jen k lepšímu: když by zásah ubral obsah nebo do textu protekla instrukce, oprava se zahodí a původní odstavec zůstane.

Příklady, na kterých se běh zastaví

Všechno níže jsou skutečné třídy nálezů z ostrých běhů, ne vymyšlené ukázky.

Zadání, které nedává smysl

Text, který si vymýšlí

Prázdno vydávané za odpověď

Proč ‹OVĚŘIT› není chyba

Prázdné pole neznamená „ne“. Když v zadání chybí údaj, má systém dvě možnosti: buď napsat autoritativní větu, která zní dobře a může být nepravdivá, nebo přiznat mezeru. Volíme druhé.

Značka ‹OVĚŘIT› v textu je místo, kde rozhodujete vy. V exportu z ní je zvýrazněný odstavec a k dokumentaci dostanete samostatný seznam bodů k ověření. Dokud v dokumentu takové místo zůstane, výstup nemůže skončit jako ověřený — ani omylem.

Podhodnocený nebo nadhodnocený výsledek, který vypadá autoritativně, je horší než přiznaná mezera. — jedno z pravidel, která v enginu drží testy.

Čísla počítá engine, ne model

Parkovací stání, bilance potřeby vody, objemy zemních prací, hmotnosti demoličních odpadů — to všechno je deterministický výpočet podle předpisu. Model tato čísla nesmí měnit; jen kolem nich píše text. U každého výpočtu je v dokumentu vidět rozklad, ze kterého vznikl, takže si ho můžete přepočítat na papíře.

Podle jakého znění se počítá, určuje datum dokumentace. Když je záměr zpracovaný před účinností novely, dokument to sám pozná a řekne, které požadavky se ho podle přechodných ustanovení netýkají.

Co nekontrolujeme

Generujeme textové části dokumentace. Výkresy, situace, požárně bezpečnostní řešení, statický výpočet ani dokladovou část neděláme — a tudíž je ani neposuzujeme. Odpovědnost za dokumentaci zůstává na autorizované osobě; nástroj ji připravuje, nenahrazuje. Podrobněji v častých dotazech.

Nejlepší způsob, jak si to ověřit, je pustit to na vlastním projektu. První 3 sady jsou zdarma.

Požádat o přístup Praha a PSP →