Hilft oder schadet unsere Produktdokumentation tatsächlich unserer AI-Sichtbarkeit? Wie sollten Docs strukturiert sein?

Ihr JavaScript-Problem ist wahrscheinlich die Ursache. Hier die technische Realität:

Wie AI-Crawler sich von Googlebot unterscheiden:

Ihre React-Doku-Seite:

Wenn Inhalte nach dem Laden per JavaScript geladen werden, sehen AI-Crawler:

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

Statt Ihrer eigentlichen Dokumentation.

Lösungen (von wenig bis viel Aufwand):

1. Pre-Rendering/SSR – Seiten serverseitig rendern, damit HTML den Inhalt enthält
2. Statische Seitengenerierung – Doku zu statischen HTML-Dateien bauen
3. Hybrider Ansatz – SSR für kritische Seiten, clientseitig für interaktive Elemente

Schnelle Überprüfung:

1. Seitenquelltext (nicht Inspector) Ihrer Doku-Seiten ansehen
2. Wenn Sie echten Inhalt sehen = gut
3. Wenn Sie leere divs sehen = AI sieht nichts

Framework-Optionen:

• Docusaurus (statisch + SSR)
• GitBook (vorgerendert)
• Mintlify (statisch)
• VitePress (statisch)

Alle erzeugen HTML, das AI-Crawler lesen können.

Abgesehen vom JS-Problem: Lassen Sie uns über Strukturoptimierung sprechen:

Dokumentationsstruktur, die AI liebt:

1. Klare Überschriftenhierarchie

H1: Funktionsname
  H2: Was ist [Funktion]?
  H2: Wie nutzt man [Funktion]
    H3: Schritt 1
    H3: Schritt 2
  H2: Fehlerbehebung
  H2: FAQ

2. Antwort-orientierte Inhalte Jeder Abschnitt sollte mit einer direkten Antwort beginnen, dann erklären:

Gut: “Um Produkt X zu installieren, führen Sie npm install productx aus. Dieser Befehl lädt das Paket von npm herunter und fügt es zu Ihren Abhängigkeiten hinzu.”

Schlecht: “Wenn Sie bereit sind, unser Produkt zu nutzen, sollten Sie sicherstellen, dass alles richtig konfiguriert ist. Fangen wir zunächst mit den Abhängigkeiten an …”

3. Abgeschlossene Abschnitte Jeder H2-Abschnitt sollte auch für sich verständlich sein. AI zitiert eventuell nur einen Abschnitt.

4. Explizite Definitionen Nicht auf Kontext verlassen:

• “Produkt X ist ein Projektmanagement-Tool, das …”
• “Das API-Rate-Limit beträgt 100 Anfragen pro Minute”
• “SSO (Single Sign-On) ermöglicht Nutzern …”

Schema-Markup für Dokumentationen – wird oft übersehen:

Wichtige Schemas für Docs:

1. Article/TechArticle-Schema

{
  "@type": "TechArticle",
  "headline": "How to Configure SSO",
  "datePublished": "2026-01-01",
  "dateModified": "2026-01-05",
  "author": {
    "@type": "Organization",
    "name": "Ihr Unternehmen"
  }
}

2. FAQPage-Schema – Für Troubleshooting-/FAQ-Bereiche

{
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "Wie setze ich mein Passwort zurück?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "Gehen Sie zu Einstellungen > Sicherheit > Passwort zurücksetzen ..."
    }
  }]
}

3. HowTo-Schema – Für Schritt-für-Schritt-Anleitungen

{
  "@type": "HowTo",
  "name": "Wie installiert man Produkt X",
  "step": [{
    "@type": "HowToStep",
    "text": "Öffnen Sie das Terminal und führen Sie npm install ... aus"
  }]
}

Einfluss auf AI:

Schema garantiert keine AI-Zitate, aber es:

• Hilft AI, den Inhaltstyp zu verstehen
• Macht Informations-Extraktion leichter
• Signalisiert strukturierte, verlässliche Informationen
• Verbessert Perplexity-Ranking (~10% Faktor)

Umsetzungstipp:

Beginnen Sie mit dem FAQPage-Schema bei Ihren meistgefragten Themen. Es ist am einfachsten umzusetzen und hat den größten Effekt.

Dokumentations-SEO-Perspektive mit AI-Fokus:

Was wir an unseren Docs geändert haben:

URL-Struktur, die funktioniert:

Gut: /docs/features/sso-configuration Schlecht: /docs/article/12345

Beschreibende URLs helfen AI, den Inhalt schon vor dem Lesen einzuordnen.

Interne Verlinkung:

Verweisen Sie stark auf verwandte Dokumente:

• “Mehr zu [verwandte Funktion]”
• “Siehe auch: Fehlerbehebung [Thema]”
• “Voraussetzungen: [anderes Dokument]”

Das hilft AI, thematische Zusammenhänge zu erkennen und Ihre Autorität einzuschätzen.

Frische-Signale:

• „Zuletzt aktualisiert“-Datum sichtbar anzeigen
• Korrekte lastmod in Sitemaps nutzen
• Inhalte tatsächlich aktualisieren (AI erkennt echte Änderungen)

Dieser Thread war unglaublich hilfreich. Mein Aktionsplan:

Sofort (Woche 1):

1. JS-Problem validieren – Erledigt, bestätigt, dass view-source leere divs zeigt
2. Pre-Rendering recherchieren – Prerender.io als schnelle Lösung im Blick
3. Top-Seiten priorisieren – 50 meistbesuchte Docs für SSR identifizieren

Kurzfristig (Woche 2-4):

4. Pre-Rendering umsetzen – HTML für AI-Crawler sichtbar machen
5. FAQPage-Schema hinzufügen – Start im Troubleshooting-Bereich
6. Top-Dokumente umstrukturieren – Antwort-orientiert, klare Überschriften

Mittelfristig (Monat 2-3):

7. Plattform evaluieren – Wechsel auf statische Doku-Plattform erwägen?
8. Vollständige Schema-Implementierung – TechArticle, HowTo auf der ganzen Seite
9. Content-Audit – Überall abgeschlossene Abschnitte sicherstellen

Erfolgsmetriken:

• View-source zeigt echten Inhalt
• AI-Zitat-Tracking via Am I Cited
• Mehr Doku-Seiten in AI-Antworten
• Konkrete Doku-URLs in Zitaten

Die Erkenntnis:

Unsere Dokumentation könnte unser größtes AI-Sichtbarkeits-Asset sein – sie ist umfassend, exakt und autoritativ. Aber das nützt nichts, wenn AI sie nicht lesen kann.

Für andere Doku-Teams:

Prüft Euren view-source jetzt. Wenn er leer ist, seid Ihr für AI unsichtbar – egal wie gut Eure Inhalte sind.

Danke an alle!