Dokumentace k systému, který nikdo neznal

Dostali jsme k zákaznickému projektu hromadu podkladů. Kód, PDF, Wordy, obrázky, Excely - roky vývoje. A bylo to skoro horší, než kdybychom nedostali nic: nikdo nevěděl, co z toho ještě platí.
Ve druhém dílu série Napřímo s AI vypráví Filip Šabacký (Development Lead, CEOS Data): u staré aplikace s roky historie je první krok dokumentace - teprve pak má smysl migrace nebo AI vývoj. Klára Nováková (HR, CEOS Data) se ptá na to, co možná napadá i vás. Na konci uvidíte živou ukázku: z balíku starých podkladů vznikne dokumentace ve variantách pro vývojáře, analytika i management.
Co si z dílu odnesete:
- U staré aplikace je první krok dokumentace - teprve pak má smysl migrace nebo AI vývoj.
- Nejtěžší není dokumentaci napsat. Těžší je prohrabat se balastem a zjistit, co je vůbec aktuální a důležité.
- Bez dobré dokumentace si AI na velkém projektu spíš uškodí, než pomůže.
- Jeden zdroj, různé podoby: dokumentace pro vývojáře, analytika i management, ve Wordu i HTML.
Kapitoly:
0:00 Úvod a navázání na první díl
4:38 Proč je dokumentace u AI klíčová
7:29 Zákaznický projekt: stará aplikace, roky vývoje
10:27 Hlavní oříšek: co je vlastně aktuální a důležité
17:48 Přechod na ukázku - co budeme dokumentovat
20:47 Úprava a přizpůsobení šablon
24:11 Generování dokumentace a její zobrazení
28:09 Výstup ve variantách a formátech (Word, HTML)
28:56 Co chystáme dál + web série
Web série a další díly: https://www.naprimosai.cz
ČERNÁ AI festival - 15. 9., Gong Vítkovice: https://cernaaifestival.cz/
Sérii Napřímo s AI pořádá CEOS Data ve spolupráci s komunitou ČERNÁ.AI. Každý díl: reálný příběh z praxe a živá ukázka.