Wie Docsbook seine Behauptungen belegt
Dokumentationsplattformen werden mit Adjektiven verkauft – fortschrittlich, intelligent, optimiert. Adjektive sind nicht falsifizierbar und tragen daher keine Information. Diese Dokumentation folgt stattdessen einer Regel: Eine Funktionsseite muss es einem skeptischen Ingenieur ermöglichen, uns zu überprüfen. Wenn ein Satz die Frage „Wer sagt das?“ nicht übersteht, wird er nicht veröffentlicht.
Diese Seite ist die Regel selbst, sodass Sie uns daran messen können.
Was jede Funktionsseite enthält#
Jede Seite unter SEO, GEO, AEO, Agentenfreundliche Inhalte, KI-Chat, Analytics und Übersetzungen enthält in dieser Reihenfolge vier Blöcke.
| Block | Was er enthalten muss | So überprüfen Sie ihn |
|---|---|---|
| Was Sie erhalten | Das Ergebnis in Ihren Begriffen – was auf der Seite, im Panel oder in der API erscheint | Öffnen Sie Ihre eigene Website und sehen Sie nach |
| Wie es erstellt wird | Der Mechanismus auf einer Ebene, die nur jemand beschreiben könnte, der die Implementierung gelesen hat: Schwellenwerte, Reihenfolge der Präferenzen, Fallbacks, was bei einem Fehler geschieht | Vergleichen Sie dies mit dem gerenderten HTML, der API-Antwort oder den exportierten Daten |
| Belege | Jede Regel als Regel → warum sich die Maschine oder der Leser so verhält → ein Link zu einer Primärquelle | Öffnen Sie den Link |
| Grenzen | Was die Funktion nicht tut, was nicht gemessen wird und was von einer Modellversion abhängt, die wir nicht kontrollieren | Beurteilen Sie, ob wir etwas ausgelassen haben |
Eine Seite ohne Block zu den Grenzen ist eine Broschüre, und Broschüren wird weniger geglaubt, nicht mehr.
Was hier als Quelle gilt#
Wir bewerten Quellen, und die Bewertung zeigt sich darin, wie eine Behauptung formuliert ist.
- Spezifikationen und Dokumentation der Anbieter — Google Search Central, schema.org, W3C, die IETF, die Model Context Protocol-Spezifikation, die llms.txt-Spezifikation und die veröffentlichte Dokumentation der beteiligten Modellanbieter. Eine Behauptung, die auf einer dieser Quellen beruht, wird ohne Einschränkung formuliert.
- Begutachtete oder als Preprint veröffentlichte Forschung mit einer angegebenen Methode und Stichprobengröße. Mit der Methode angegeben: „an 10.000 Suchanfragen gemessen“ zeigt, wie weit man ihr vertrauen kann.
- Unabhängige Studien mit veröffentlichter Methodik. In jedem Satz der Quelle zugeschrieben — „X hat gemessen“, niemals „es ist bekannt, dass“.
- Von Anbietern gemeldete Ergebnisse, einschließlich unserer eigenen. Als von Anbietern gemeldet gekennzeichnet. Unsere eigenen internen Messungen sind als unsere gekennzeichnet.
Alles unterhalb dieser Grenze ist kein Beleg und erscheint nicht.
Was wir bewusst nicht behaupten#
Dies sind die Aussagen, die von einem Dokumentationsanbieter erwartet werden, und der Grund, warum wir sie nicht machen.
- Keine Steigerung der Zitierhäufigkeit. Niemand kann ehrlich versprechen, dass das Aktivieren einer Funktion dazu führt, dass Perplexity oder ChatGPT Sie N % häufiger zitieren. Was in kontrollierten Untersuchungen gemessen wurde, ist enger gefasst als die Marketingversion davon, und GEO sagt genau, was gemessen wurde und von wem.
- Kein Prozentsatz zur Genauigkeit von KI-Antworten. Eine Zahl, die in unserem eigenen Korpus mit unserem eigenen Bewertungsverfahren erzeugt wurde, ist kein Beleg für Ihr Korpus. KI-Chat beschreibt, was die Pipeline tut, um auf verlässlichen Informationen zu basieren, und was sie misst, ohne einen Wert zu erfinden.
- Keine Ranking-Garantien. Das Suchranking ist kein Vertrag, und Google sagt dies auch in seiner eigenen Dokumentation. SEO trennt, was von Google dokumentiert ist, von dem, was eine Schlussfolgerung darstellt.
- Kein Compliance-Status, den wir nicht erreicht haben. MCP-Sicherheit legt die aktuelle Position dar und benennt, was derzeit noch nicht angeboten wird.
„Ungeklärt“-Blöcke#
Wenn eine Behauptung in dieser Dokumentation nicht überprüft werden kann – der Mechanismus sich geändert hat, sich herausstellt, dass die Quelle nicht das besagt, wofür sie zitiert wurde, oder niemand eine Messung veröffentlicht hat –, löschen wir den Satz nicht und schwächen ihn auch nicht zu einer vagen Aussage ab. Er wird zu einem ausdrücklichen Block:
Ungeklärt. Die Behauptung. Was überprüfbar ist: der Teil, der überprüfbar ist. Was nicht überprüfbar ist: der Teil, der es nicht ist, und warum. Behandle sie als Hypothese, bis sie gemessen wurde.
Dieser Block ist ein Versprechen über unseren Prozess: Eine Behauptung, die wir nicht stützen können, ist für dich sichtbar, anstatt stillschweigend entfernt zu werden.
Wie diese Aussagen Bestand haben#
Dokumentation entfernt sich stillschweigend von einem Produkt – genau diesen Fehler soll Docsbook beheben. Deshalb läuft dieselbe Infrastruktur auch für diese Dokumentation.
- Jede für Nutzer sichtbare Änderung wird mit einem Eintrag im Änderungsprotokoll veröffentlicht, der festhält, welchen Nutzen die Änderung bringen sollte, nicht nur, was geändert wurde.
- Das Änderungsprotokoll wird in Seiten nach Ergebnis aufgeteilt, sodass du die Entwicklung eines einzelnen Ergebnisses – KI-Zitate, Supportaufwand, organischer Traffic – statt einer flachen Liste lesen kannst.
- Auf den Seiten wird ein sichtbares Datum der letzten Änderung angezeigt, das aus dem Commit stammt, durch den sie geändert wurden, sodass eine veraltete Seite nicht so tun kann, als wäre sie aktuell. Siehe GEO.
Etwas stimmt nicht?#
Eine Aussage auf diesen Seiten, die nicht mit dem übereinstimmt, was das Produkt tatsächlich tut, ist ein Fehler, und wir hören lieber von dir davon, als dass er dort bestehen bleibt.
- Schreibe eine E-Mail an support@docsbook.io und nenne die Seite sowie den betreffenden Satz.
- Oder teile es im Docsbook Discord mit.