Opravdu naše produktová dokumentace pomáhá, nebo škodí naší viditelnosti v AI? Jak by měly být dokumenty strukturovány?

Váš problém s JavaScriptem je pravděpodobně příčinou. Tady je technická realita:

Jak se AI crawlery liší od Googlebotu:

Váš React dokumentační web:

Pokud je obsah načítán přes JavaScript po načtení stránky, AI crawlery vidí:

<div id="root"></div>

Místo vaší skutečné dokumentace.

Řešení (od nejméně po nejvíce náročná):

1. Předběžné vykreslování/SSR – Stránky se vykreslují na serveru, takže HTML obsahuje obsah
2. Generování statického webu – Dokumentace se sestaví do statických HTML souborů
3. Hybridní přístup – SSR pro klíčové stránky, klientská logika pro interaktivní prvky

Rychlá validace:

1. Zobrazte zdrojový kód stránky (ne inspektor) na dokumentačních stránkách
2. Pokud vidíte skutečný obsah = v pořádku
3. Pokud vidíte prázdné divy = AI nevidí nic

Možnosti frameworku:

• Docusaurus (statický + SSR)
• GitBook (předrenderované)
• Mintlify (statický)
• VitePress (statický)

Všechny generují HTML, které AI crawlery umí přečíst.

Kromě problému s JS pojďme mluvit o optimalizaci struktury:

Struktura dokumentace, kterou má AI ráda:

1. Jasná hierarchie nadpisů

H1: Název funkce
  H2: Co je [funkce]?
  H2: Jak používat [funkci]
    H3: Krok 1
    H3: Krok 2
  H2: Řešení problémů
  H2: FAQ

2. Obsah s odpovědí na začátku Každá sekce by měla začínat přímou odpovědí, teprve pak vysvětlovat:

Dobře: “Pro instalaci produktu X spusťte npm install productx. Tento příkaz stáhne balíček z npm a přidá jej do vašich závislostí.”

Špatně: “Až budete připraveni začít používat náš produkt, budete se chtít ujistit, že je vše správně nakonfigurováno. Nejdřív si povíme o závislostech…”

3. Samosatné sekce Každá H2 sekce by měla dávat smysl i samostatně. AI může citovat pouze jednu sekci.

4. Explicitní definice Neberte kontext jako samozřejmost:

• “Produkt X je nástroj pro řízení projektů, který…”
• “Limit API je 100 požadavků za minutu”
• “SSO (Single Sign-On) umožňuje uživatelům…”

Schéma značkování pro dokumentaci – to je často přehlíženo:

Základní schémata pro dokumentaci:

1. Schéma Article/TechArticle

{
  "@type": "TechArticle",
  "headline": "Jak nastavit SSO",
  "datePublished": "2026-01-01",
  "dateModified": "2026-01-05",
  "author": {
    "@type": "Organization",
    "name": "Vaše společnost"
  }
}

2. Schéma FAQPage – Pro sekce řešení problémů/FAQ

{
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "Jak resetuji heslo?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "Přejděte do Nastavení > Zabezpečení > Resetovat heslo..."
    }
  }]
}

3. Schéma HowTo – Pro návody krok za krokem

{
  "@type": "HowTo",
  "name": "Jak nainstalovat produkt X",
  "step": [{
    "@type": "HowToStep",
    "text": "Otevřete terminál a spusťte npm install..."
  }]
}

Dopad na AI:

Schéma nezaručuje AI citace, ale:

• Pomáhá AI pochopit typ obsahu
• Umožňuje snazší extrakci informací
• Signalizuje strukturované, důvěryhodné informace
• Zlepšuje hodnocení v Perplexity (~10% faktor)

Tip k implementaci:

Začněte se schématem FAQPage u nejčastěji dotazovaných témat. Je nejjednodušší na implementaci a má největší dopad.

SEO pohled na dokumentaci s ohledem na AI:

Co jsme v dokumentaci změnili:

Struktura URL, která funguje:

Dobré: /docs/features/sso-configuration Špatné: /docs/article/12345

Popisné URL pomáhají AI pochopit obsah ještě před jeho načtením.

Vnitřní prolinkování:

Hojně odkazujte na související dokumenty:

• “Zjistěte více o [související funkci]”
• “Viz také: Řešení problémů [téma]”
• “Předpoklady: [jiný dokument]”

To pomáhá AI chápat tematické souvislosti a posiluje vaši autoritu.

Signály aktuálnosti:

• Viditelně zobrazujte datum “Poslední aktualizace”
• Používejte přesné lastmod v sitemapách
• Obsah skutečně aktualizujte (AI rozpozná věcné změny)

Tato diskuze mi neskutečně pomohla. Tady je můj akční plán:

Ihned (1. týden):

1. Ověřit JS problém – Hotovo, potvrzeno že ve view-source jsou prázdné divy
2. Prozkoumat předrenderování – Zvažuji Prerender.io jako rychlé řešení
3. Prioritizovat top stránky – Najít 50 nejnavštěvovanějších dokumentů pro SSR

Krátkodobě (2.–4. týden):

4. Implementovat předrenderování – Zajistit HTML pro AI crawlery
5. Přidat FAQPage schéma – Začít sekcí řešení problémů
6. Restrukturalizovat top dokumenty – Odpověď na začátku, jasné nadpisy

Střednědobě (2.–3. měsíc):

7. Zhodnocení platformy – Máme přejít na statickou dokumentační platformu?
8. Kompletní implementace schémat – TechArticle, HowTo napříč webem
9. Audit obsahu – Zajistit samostatnost jednotlivých sekcí

Metriky úspěchu:

• Ve view-source skutečný obsah
• Sledování AI citací přes Am I Cited
• Více dokumentačních stránek v AI odpovědích
• Konkrétní URL dokumentů ve citacích

Zásadní poznatek:

Naše dokumentace může být největším aktivem pro AI viditelnost – je komplexní, přesná a autoritativní. Ale to vše je k ničemu, pokud ji AI nedokáže přečíst.

Pro další dokumentační týmy:

Zkontrolujte view-source právě teď. Pokud je prázdný, jste pro AI neviditelní, bez ohledu na kvalitu obsahu.

Díky všem!