Podle empirických studií tráví vývojáři 58–70 % svého pracovního času čtením a porozuměním existujícímu kódu, nikoli jeho psaním. Většina kódů však má dokumentaci, která je buď zastaralá, neúplná, nebo neexistuje.
V tomto článku vám ukážeme, jak zefektivnit proces dokumentace a zajistit soulad v týmu pomocí návrhů GitHub Copilot založených na umělé inteligenci. Uvidíte, jak můžete generovat docstrings, inline komentáře a soubory README přímo ve vašem IDE a poté tyto dokumenty integrovat do udržitelného pracovního postupu s ClickUp.
Proč je dokumentace kódu tak náročná
Hlavní problémy s dokumentací kódu lze rozdělit do těchto jednoduchých bodů:
- Zastaralé informace: Dokumentace často zastará v okamžiku, kdy dojde ke změně kódu, což vede k rozporu mezi tím, co kód dělá, a tím, co uvádí dokumentace.
- Chybějící odborníci: Když původní vývojáři opustí projekt, jejich nedokumentovaný kód se stane černou skříňkou, která zpomaluje celý tým a vytváří znalostní silosy. To přispívá k rozptýlení kontextu – týmy ztrácejí hodiny hledáním informací v nesouvislých aplikacích, pátráním po souborech a přepínáním mezi platformami. Také to téměř znemožňuje přenos znalostí. Noví členové týmu čelí strmé křivce učení a snaží se efektivně přispívat.
- Časové kompromisy: Vzhledem k napjatým termínům se většina vývojářů soustředí nejprve na dodání funkcí, což ztěžuje udržování dokumentace v aktuálním stavu a časem vede k narůstání technického dluhu. Nejde jen o časové omezení, ale také o související tření. Neustálé přepínání mezi psaním kódu a psaním prózy narušuje pracovní rytmus vývojáře, snižuje produktivitu a způsobuje, že dokumentace se jeví jako nepříjemná povinnost.
- Složitost staršího kódu: Starší, složité kódové základny mají často minimální nebo zavádějící dokumentaci, což značně ztěžuje jejich rozluštění a aktualizaci.
- Růstové bolesti: I u projektů, které začínají s velkými ambicemi, je nevyhnutelné, že dojde k odchylkám v dokumentaci. Jak se kód stává složitějším a funkce se vyvíjejí, dokumentace přestává být synchronizovaná, což podkopává důvěru a snižuje její udržovatelnost.
Používání GitHub Copilot pro dokumentaci kódu může být pro vývojáře, technické týmy a kohokoli, kdo spravuje kódové základny a má potíže s udržováním dokumentace aktuální, zásadním zlomem.
📮 ClickUp Insight: Průměrný profesionál stráví více než 30 minut denně hledáním informací souvisejících s prací – to je více než 120 hodin ročně ztracených prohledáváním e-mailů, vláken Slacku a roztroušených souborů.
Inteligentní asistent AI zabudovaný do vašeho pracovního prostoru to může změnit. Představujeme ClickUp Brain. Poskytuje okamžité informace a odpovědi tím, že během několika sekund vyhledá správné dokumenty, konverzace a podrobnosti úkolů, takže můžete přestat hledat a začít pracovat.
💫 Skutečné výsledky: Týmy jako QubicaAMF ušetřily díky ClickUp více než 5 hodin týdně, což představuje přes 250 hodin ročně na osobu, a to díky odstranění zastaralých procesů správy znalostí. Představte si, co by váš tým mohl vytvořit s extra týdnem produktivity každý čtvrtrok!
Co potřebujete před použitím GitHub Copilot pro dokumentaci
Používání nového nástroje bez správného nastavení vede k frustraci. Než začnete generovat dokumentaci, rychle si projděte tento kontrolní seznam, abyste se ujistili, že je váš pracovní prostor připraven. Ušetříte si tak pozdější potíže.
- Účet GitHub s přístupem k Copilotu: Copilot je služba založená na předplatném. Budete potřebovat aktivní předplatné, ať už se jedná o individuální, firemní nebo podnikový plán.
- Podporované IDE: Ačkoli VS Code je nejběžnějším prostředím, Copilot se také hladce integruje s sadou IDE JetBrains (jako PyCharm nebo WebStorm), Visual Studio a Neovim.
- Nainstalované rozšíření Copilot: Musíte nainstalovat oficiální rozšíření GitHub Copilot z obchodu vašeho IDE a ověřit ho pomocí svého účtu GitHub.
- Copilot Chat povolen: Pro dokumentační úkoly je Copilot Chat vaším nejvýkonnějším nástrojem. Poskytuje konverzační rozhraní pro zadávání požadavků, které je pro generování vysvětlení mnohem efektivnější než spoléhání se pouze na inline návrhy.
- Přístup k úložišti: Ujistěte se, že máte alespoň přístup pro čtení k úložišti kódu, které chcete dokumentovat. Nemůžete dokumentovat to, co nevidíte.
- Základní znalost formátů dokumentace: Copilot sice odvádí většinu práce, ale základní znalost docstringů, Markdownu a specifických konvencí dokumentace vašeho programovacího jazyka vám pomůže efektivněji řídit AI.
📖 Přečtěte si také: Jak používat AI ve vývoji softwaru (případy použití a nástroje)
Jak GitHub Copilot pomáhá s dokumentací kódu
GitHub Copilot si můžete představit jako asistenta pro kódování, který rozumí kontextu vašeho kódu. Nejenže hádá, ale čte podpisy funkcí, názvy proměnných a okolní logiku, aby vygeneroval relevantní dokumentaci.
Použití GitHub Copilot pro dokumentaci kódu zjednodušuje zdlouhavý proces na několik jednoduchých kroků.
Takto to funguje v praxi:
- Vložené návrhy: Jakmile začnete psát značky komentářů (např. // nebo #) nebo syntaxi docstringů (např. """), Copilot předvídá váš záměr a automaticky doplňuje kontextově citlivou dokumentaci.
- Copilot Chat pro vysvětlení: Můžete otevřít okno chatu a požádat Copilot, aby vám vysvětlil, co daná funkce nebo blok kódu dělá. Vygeneruje jasný souhrn připravený k dokumentaci, který můžete zkopírovat a vložit.
- Dokumentace založená na výběru: Stačí zvýraznit blok kódu, kliknout pravým tlačítkem myši a požádat Copilot, aby zdokumentoval tento konkrétní výběr. To je ideální pro zaměření se na složité funkce nebo třídy.
- Podpora více jazyků: Copilot není omezen na jeden jazyk. Funguje v jazycích Python, JavaScript, TypeScript, Java, C#, Go a mnoha dalších populárních programovacích jazycích.
- Vnímání kontextu: To je super schopnost Copilotu. Nezabývá se pouze kódem izolovaně, ale analyzuje, jak různé části souboru vzájemně interagují, aby generoval přesnější a užitečnější popisy.
| Přístup | Rychlost | Přesnost | Konzistence |
|---|---|---|---|
| Manuální dokumentace | Pomalý | Vysoká (pokud je provedena správně) | Liší se podle autora |
| Návrhy GitHub Copilot | Rychlé | Středně vysoká | Konzistentní styl |
| Výzvy Copilot Chat | Rychlé | Vysoká (s dobrými výzvami) | Velmi konzistentní |
Chcete-li vidět, jak agenti AI mění pracovní postupy při programování nejen v oblasti dokumentace, podívejte se na toto video.
Podrobný průvodce generováním dokumentace pomocí GitHub Copilot
Tento pracovní postup je vaším tutoriálem GitHub Copilot pro přeměnu neznámé nebo nedokumentované kódové základny na dobře zdokumentovaný zdroj. Postupováním podle těchto kroků můžete systematicky vytvářet komplexní dokumentaci pomocí AI. 🛠️
Krok 1: Pochopte strukturu kódové základny
Nemůžete dokumentovat to, čemu nerozumíte. Když čelíte novému nebo složitému projektu, prvním krokem je získat obecný přehled. Místo toho, abyste trávili hodiny ručním sledováním souvislostí, použijte Copilot Chat jako svého průvodce.
Otevřete hlavní složku projektu ve svém IDE a položte Copilot Chat obecné otázky, abyste se zorientovali.
- „Vysvětlete celkovou strukturu tohoto úložiště“
- „Jaké jsou hlavní moduly a jak spolu interagují?“
- „Shrňte, co tento soubor dělá“
Praktickým tipem je začít s vstupními body aplikace, jako jsou main.py, index.js nebo primární soubor tras API. Pochopení toho, kde program začíná, vám pomůže sledovat tok logiky a závislostí směrem ven.
Krok 2: Generujte souhrny funkcí a tříd
Právě zde pocítíte okamžitý dopad Copilotu. Generování docstringů – souhrnů, které vysvětlují, co funkce nebo třída dělá – je neuvěřitelně rychlé. Pracovní postup je jednoduchý: umístěte kurzor, zadejte počáteční syntaxi pro docstring a Copilot se postará o zbytek.
- Pro Python: Umístěte kurzor na řádek za definicí funkce a zadejte „““. Copilot okamžitě navrhne kompletní docstring, včetně popisů parametrů (Args), návratových hodnot (Returns) a všech výjimek, které funkce může vyvolat (Raises).
- Pro JavaScript/TypeScript: Umístěte kurzor nad funkci a zadejte /. Copilot vygeneruje komentáře ve stylu JSDoc, které jsou standardem pro dokumentaci kódů JavaScript.
Pro větší kontrolu můžete také použít Copilot Chat. Zvýrazněte celou funkci nebo třídu a zeptejte se přímo: „Zdokumentujte tuto funkci, včetně parametrů a typu návratové hodnoty. “
Krok 3: Přidejte vložené komentáře pro složitou logiku
Zatímco docstrings vysvětlují co, inline komentáře vysvětlují proč. Vaším cílem zde není znovu vysvětlovat, co kód dělá, ale objasnit záměr za nejasnými rozhodnutími. To je zásadní pro budoucí udržovatelnost.
Zaměřte se na nejobtížnější části svého kódu. Zvýrazněte složitý blok a zeptejte se Copilot Chat: „Vysvětli mi tuto logiku krok za krokem.“ Poté vezměte jeho vysvětlení a zredukujte ho do stručného vloženého komentáře.
Vhodná místa pro přidání vložených komentářů zahrnují:
- Složité regulární výrazy (regex)
- Optimalizace výkonu využívající nekonvenční logiku
- Řešení známých chyb nebo problémů s knihovnami třetích stran
- Obchodní logika, která není okamžitě zřejmá pouze z názvů proměnných
Krok 4: Vytvořte README a dokumentaci projektu
Jakmile zvládnete dokumentaci na úrovni kódu, je čas přejít na úroveň projektu. Dobrý soubor README je vstupní branou do vašeho projektu a Copilot vám pomůže vytvořit takový, který vynikne, podobně jako nejlepší dokumentace API.
Postupujte takto:
- Vytvořte nový soubor README.md v kořenovém adresáři svého projektu.
- Pomocí Copilot Chat vygenerujte hlavní sekce. Můžete například zadat: „Vygenerujte soubor README pro tento projekt, včetně sekcí instalace, použití a přispívání.“ Copilot prohledá soubory vašeho projektu (například package.json nebo requirements.txt) a vytvoří přesné pokyny k instalaci a příklady použití.
- Poté můžete vygenerovaný Markdown vylepšit a přizpůsobit tak, aby vyhovoval specifickým potřebám vašeho projektu. Stejný proces funguje i pro vytváření CONTRIBUTING.md nebo jiných dokumentů projektu na vysoké úrovni.
Krok 5: Zkontrolujte a vylepšete dokumentaci generovanou umělou inteligencí
Toto je nejdůležitější krok. Dokumentace generovaná umělou inteligencí je silným výchozím bodem, ale není hotovým produktem. Vždy ji považujte za první návrh, který vyžaduje lidskou kontrolu a vylepšení.
Při kontrole se řiďte tímto kontrolním seznamem:
- Přesnost: Popisuje dokumentace správně to, co kód skutečně dělá?
- Úplnost: Jsou zdokumentovány všechny parametry, návratové hodnoty a potenciální výjimky?
- Srozumitelnost: Pochopil by to nový člen týmu, aniž by musel žádat o pomoc?
- Konzistence: Odpovídá tón a styl dokumentace zavedeným standardům vašeho týmu?
- Okrajové případy: Jsou zmíněna důležitá omezení nebo potenciální okrajové případy?
Příklad dokumentace GitHub Copilot v praxi
Podívejme se na konkrétní příklad. Představte si, že narazíte na tuto nedokumentovanou funkci Pythonu v zastaralé kódové základně:
Není hned jasné, co dělá a proč. Můžete funkci zvýraznit a zeptat se Copilot Chat: „Zdokumentujte tuto funkci včetně parametrů, typu návratové hodnoty a výjimek. “
Během několika sekund Copilot poskytuje následující:
Tento příklad ukazuje generování dokumentace GitHub Copilot pro jednu funkci. U větších kódových bází můžete tento proces systematicky opakovat, počínaje veřejnými API a pokračovat směrem k interním nástrojům.
Osvědčené postupy pro dokumentaci kódu pomocí umělé inteligence
Generování dokumentace je jen polovina úspěchu. Skutečnou výzvou je udržet ji užitečnou a aktuální. V tomto případě musíte jít nad rámec IDE a integrovat dokumentaci do základních pracovních postupů vašeho týmu.
Kombinujte GitHub Copilot s nástroji pro správu projektů
Centralizujte své dokumentační a vývojové úkoly, abyste eliminovali chaos a udrželi svůj tým v souladu. Kombinujte GitHub Copilot s nástroji pro správu projektů, jako je ClickUp, abyste mohli vytvářet konkrétní, přiřaditelné pracovní položky pro dokumentaci, propojit je přímo se změnami kódu a vybudovat centralizovanou znalostní bázi, která se integruje do vašeho pracovního postupu – a umožní tak vašemu týmu jednat rychleji.
ClickUp to usnadňuje díky nativní integraci GitHubu. To je obzvláště užitečné, když více repozitářů Git přispívá do stejné produktové oblasti a vy stále chcete mít jediný zdroj pravdivých informací o stavu a kontextu.
Synchronizujte dokumentaci se změnami v kódu
V okamžiku, kdy dojde ke změně kódu, začne dokumentace ztrácet na aktuálnosti. Právě tento „posun v dokumentaci“ způsobuje, že většina týmových wiki je nespolehlivá. Můžete tomu zabránit vytvořením procesu, který zajistí synchronizaci vašich dokumentů s kódem.
- Dokumentace během kontroly PR: Udělejte aktualizace dokumentace povinnou součástí kontrolního seznamu pull requestů vašeho týmu, což je klíčový krok v každém solidním vývojovém workflow. Žádný kód nebude sloučen, dokud nebudou dokumenty aktualizovány.
- Použijte Copilot na změněné soubory: V rámci procesu kontroly kódu mohou recenzenti pomocí Copilotu rychle ověřit, zda dokumentace stále přesně odráží upravený kód.
- Automatizujte připomenutí: Nespoléhejte se na paměť. Nastavte automatizované pracovní postupy, které označí PR, které se týkají nedokumentovaného kódu, nebo připomenou vývojářům, aby aktualizovali dokumentaci.
Zajistěte plynulé a sledovatelné aktualizace dokumentace automatizací revizních úkolů pomocí ClickUp Automations pokaždé, když dojde ke sloučení požadavku GitHub pull request. Propojením GitHub PR přímo s ClickUp Tasks zajistíte, že dokumentace bude vždy viditelná a součástí každé změny kódu.
Používejte AI k udržování standardů dokumentace
Nekonzistentní dokumentace je matoucí. Když vývojáři používají mírně odlišné styly, kód se stává hůře čitelným a noví členové týmu mají potíže se zapracováním. Umělá inteligence může pomoci zajistit konzistenci napříč celou platformou.
Začněte vytvořením jasného průvodce stylem dokumentace. Poté na něj můžete odkazovat přímo v příkazech Copilotu, například „Zdokumentujte tuto funkci podle standardů JSDoc našeho týmu. “
Copilot můžete také použít k auditu stávající dokumentace a požádat jej, aby „zkontroloval tento soubor, zda neobsahuje funkce bez docstringů“.
💡Tip pro profesionály: V ClickUp můžete pomocí integrovaného asistenta AI ClickUp Brain během několika sekund vytvořit pokyny a šablony pro dokumentaci.
Aby byl tento proces škálovatelný, uložte svůj oficiální stylový průvodce dokumentací do ClickUp Docs. Vytvoříte tak sdílený systém správy znalostí, ke kterému mají přístup všichni členové týmu.
Když má nový vývojář dotaz ohledně standardů, může se zeptat ClickUp Brain, který využívá vaše dokumenty jako zdroj znalostí a poskytuje okamžité a přesné odpovědi, aniž by rušil zkušeného inženýra.
Omezení používání GitHub Copilot pro dokumentaci kódu
Copilot je sice mocným spojencem, ale je důležité si uvědomit jeho omezení. Pokud ho budete považovat za kouzelnou hůlku, může to v budoucnu vést k problémům.
- Omezení kontextového okna: Copilot může „vidět“ pouze část vašeho kódového základu najednou. U vysoce komplexních systémů s mnoha propojenými soubory nemusí být schopen uchopit celý obraz, což může vést k neúplným nebo mírně nepřesným návrhům.
- Přesnost vyžaduje ověření: Generovaná dokumentace může někdy obsahovat drobné chyby, zejména v případě jemných nuancí nebo proprietární obchodní logiky. Je to skvělý první návrh, ale vždy je třeba jej zkontrolovat lidským okem.
- Žádné institucionální znalosti: Copilot rozumí co kód dělá, ale nemá ponětí, proč bylo učiněno konkrétní rozhodnutí. Nedokáže zachytit historický kontext ani obchodní kompromisy, které vedly ke konkrétní implementaci.
- Vyžaduje předplatné: Na rozdíl od některých bezplatných nástrojů AI vyžaduje Copilot pro většinu uživatelů placené předplatné, což může být pro jednotlivce nebo malé týmy problém.
- Rozdíly v jazycích a frameworkách: Kvalita návrhů se může lišit. Copilot je mimořádně silný v populárních jazycích, jako jsou Python a JavaScript, ale může být méně efektivní v méně rozšířených jazycích nebo zcela nových frameworkách.
Tyto omezení neznamenají, že Copilot není vhodný pro dokumentaci. Pouze zdůrazňují, proč kombinace asistence AI s robustními nástroji pro workflow přináší mnohem lepší výsledky než spoléhání se pouze na jeden nástroj.
📖 Přečtěte si také: Github Copilot vs. ChatGPT: Který nástroj je pro vývojáře nejlepší?
Alternativa k GitHub Copilot pro dokumentaci kódu
Týmy, které považují dokumentaci za nedílnou součást svého pracovního postupu, a nikoli za dodatečnou záležitost, dodávají funkce rychleji a vytvářejí odolnější a udržovatelnější kódovou základnu. GitHub Copilot je sice fantastický nástroj pro generování dokumentace ve vašem IDE, ale nevyřeší větší problém.
Jak organizujete, sledujete a udržujete tuto dokumentaci jako společný týmový majetek? Právě zde se stává nezbytným konvergovaný pracovní prostor.
Zatímco Copilot vám pomáhá psát dokumenty, ClickUp vám pomáhá spravovat celý životní cyklus dokumentace. Eliminujte rozptýlení kontextu pomocí ClickUp – konvergovaného AI pracovního prostoru, který sdružuje veškerou vaši práci, data a pracovní postupy do jedné platformy.
Tým DISH Business zvýšil díky ClickUp kapacitu týmu o 30 %.
„Všechny verze, které jsme od roku 2025 vydali, byly hotové podle plánu, protože ClickUp nám poskytuje přehled o problémech, které by mohly nastat. Umožňuje týmům z různých částí světa spojit se, spolupracovat a komunikovat asynchronně o práci, kterou děláme.“
„Všechny verze, které jsme od roku 2025 vydali, byly hotové podle plánu, protože ClickUp nám poskytuje přehled o problémech, které by mohly nastat. Umožňuje týmům z různých částí světa spojit se, spolupracovat a komunikovat asynchronně o práci, kterou děláme.“
Zde je jen několik důvodů, proč vyzkoušet ClickUp ještě dnes:
- Ukládejte a spolupracujte na veškeré dokumentaci k projektům, odkazech na API a souborech README na jednom centrálním místě s možností vyhledávání pomocí ClickUp Docs.
- Pomozte členům týmu najít odpovědi na časté otázky, jako například „Jak funguje náš autentizační modul?“, pomocí ClickUp Brain, který vyhledává správné odpovědi na základě kontextu z vašeho pracovního prostoru a oficiální dokumentace.
- Automatizujte opakující se úkoly pomocí ClickUp Automations, aby se váš technický tým mohl soustředit na svou práci a efektivně vyřizovat nevyřízené úkoly.
- Udržujte týmy v obraze bez námahy nastavením AI agentů v ClickUp, kteří sledují důležité aktualizace nebo chybějící dokumentaci a upozorňují vás na ně.
GitHub Copilot vám pomůže s psaním dokumentace. ClickUp vám pomůže s její správou. Společně vyřeší všechny problémy související s dokumentací. ✨
💡Tip pro profesionály: Codegen AI Agent v ClickUp je váš autonomní AI asistent, který se postará o:
- Synchronizované aktualizace: Když dojde k aktualizaci úkolu nebo opravě chyby, agent Codegen může automaticky aktualizovat příslušnou dokumentaci. Pokud změníte logiku funkce, agent může aktualizovat odpovídající Wiki nebo technickou dokumentaci v ClickUp, aby odrážela změnu.
- Samoléčivé dokumenty: Agent vyhledává „fragmentaci kontextu“ – místa, kde se kód a dokumentace rozcházejí. Může označit zastaralé části dokumentu nebo automaticky navrhnout revizi, aby odpovídala nejnovější kódové základně.
- Automatizované poznámky k vydání: Na základě analýzy dokončených úkolů a souvisejících změn kódu ve sprintu může agent vypracovat komplexní poznámky k vydání a seznamy změn v rámci ClickUp Docs.
- Propojení kódu a dokumentace: Může automaticky vytvářet odkazy mezi úryvky kódu a dokumentací projektu na vysoké úrovni, což novým vývojářům usnadňuje pochopení „proč“ za složitými architektonickými rozhodnutími.
- Dotazy v přirozeném jazyce: Vývojáři mohou @zmínit agenta Codegen v úkolu nebo chatu a zeptat se: „Jak funguje autentizační middleware?“ Agent prohledá jak kódovou základnu, tak vaši dokumentaci ClickUp, aby poskytl ověřenou odpověď.
Více informací o Codegenu najdete v našem videu.
Usnadněte si dokumentaci kódu pomocí ClickUp
Zastaralá dokumentace zpomaluje týmy, vytváří izolované znalosti a činí zapracování nových zaměstnanců noční můrou. GitHub Copilot mění dokumentaci kódu z obávané povinnosti na efektivní pracovní postup podporovaný umělou inteligencí.
Klíčem k úspěchu je však kombinace obsahu generovaného umělou inteligencí s lidskou kontrolou a udržitelným týmovým procesem. Dokumentace, která zůstává aktuální a důvěryhodná, vyžaduje jak dobré nástroje, tak dobré návyky.
Díky ClickUp a jeho integraci s GitHubem se dokumentace kódu a její konzistentní správa stávají hračkou. Použitím umělé inteligence pro náročnou práci uvolníte vývojáře, aby se mohli soustředit na to nejdůležitější: zajištění přesnosti, úplnosti a srozumitelnosti.
Jste připraveni propojit svůj dokumentační workflow s vývojovými úkoly? Začněte s ClickUp zdarma a začněte zefektivňovat své procesy ještě dnes.
Často kladené otázky (FAQ)
GitHub Copilot dokáže generovat několik typů dokumentace, včetně docstringů funkcí a tříd, vložených komentářů vysvětlujících složitou logiku a dokumentů na úrovni projektu, jako jsou soubory README. Podporuje širokou škálu programovacích jazyků, jako jsou Python, JavaScript a Java.
Copilot je výrazně rychlejší při vytváření prvních návrhů a zkracuje práci z několika minut na několik sekund. Ruční dokumentace však může být stále přesnější pro vysoce komplexní nebo nuancovanou obchodní logiku, proto je nezbytná lidská kontrola obsahu generovaného umělou inteligencí.
Protože GitHub Copilot funguje v prostředí pro kódování, jako je VS Code, je primárně určen pro vývojáře. Dokumentaci, kterou generuje, lze však snadno exportovat nebo uložit do centrálního nástroje, jako je ClickUp Docs, a sdílet ji s členy týmu, kteří nejsou technicky zdatní.
Mezi hlavní omezení patří omezené kontextové okno, které může ovlivnit přesnost u velkých projektů, a nedostatek institucionálních znalostí o tom, proč určitý kód existuje. Veškerý obsah generovaný umělou inteligencí by měl být zkontrolován člověkem z hlediska správnosti a úplnosti. /