Inhaltsregeln für Antwortmaschinen
Eine Antwortmaschine zeigt niemals deine Seite. Sie zeigt einen Abschnitt daraus oder einen daraus neu zusammengesetzten Satz, und der Leser hört an dieser Stelle auf. Die Einheit, die du also schreibst, ist der Abschnitt, nicht das Dokument – und die folgenden Regeln sind diejenigen, die Docsbook auf Abschnitte anwendet, jeweils mit dem Mechanismus, auf den sie einwirkt, und der Quelle, die sie belegt.
Drei Dinge sind auf dieser Seite nicht enthalten. Sie ist nicht die Markup-Ebene – dafür gibt es Strukturierte Antworten. Sie ist nicht die Liste dessen, was die Wahrscheinlichkeit einer Zitierung erhöht, sobald du bereits abgerufen wurdest – dafür gibt es Zitierungssignale, die für die gemessenen Effektstärken und die Dinge zuständig ist, die du nicht tun solltest. Diese Seite enthält die Schreibregeln und für jede davon eine ehrliche Antwort auf die einzige Frage, die zählt, wenn ein Anbieter eine Regel aufstellt: macht dein Produkt das tatsächlich oder fordert es mich nur dazu auf?
Was die drei Durchsetzungsbezeichnungen bedeuten#
| Bezeichnung | Was sie bedeutet | Was passiert, wenn Sie gegen die Regel verstoßen |
|---|---|---|
| Automatisch durchgesetzt | Der Code erledigt dies oder verweigert die Ausgabe, wenn sie dagegen verstößt | Sie können über Docsbook nicht dagegen verstoßen; das Verhalten ist nicht konfigurierbar |
| Geprüft und gemeldet | Der Code misst dies und zeigt Ihnen das Ergebnis | Von selbst ändert sich nichts; Sie erhalten einen Befund mit den zugehörigen Belegen |
| Nur empfohlen | Eine Anweisung, der die Schreibagenten beim Entwerfen folgen | Danach wird nichts überprüft, auch nicht, wenn ein Mensch die Seite schreibt |
Die Regeln auf einen Blick#
| # | Regel | Durchsetzung |
|---|---|---|
| 1 | Eine Seite beantwortet eine Frage – in der Form, die diese Frage erfordert | Nur empfohlen |
| 2 | Schreibe die Überschrift als die Frage, die der Leser eingegeben hat | Nur empfohlen |
| 3 | Jeder Abschnitt muss ohne den darüberstehenden Inhalt verständlich sein | Automatisch durchgesetzt |
| 4 | Überschriftenebenen sind ein Vertrag, keine Stilentscheidung | Nur empfohlen |
| 5 | Der Überschriftentext besitzt seinen Anker – schreibe niemals selbst einen | Automatisch durchgesetzt |
| 6 | Die Antwort muss in den Bytes enthalten sein, bevor JavaScript ausgeführt wird | Geprüft und gemeldet |
| 7 | Jede Zahl in einer Aussage nennt das, was sie erzeugt hat | Automatisch durchgesetzt |
| 8 | Preise, Limits und Versionen werden kopiert, niemals abgeleitet | Automatisch durchgesetzt (generierte Preisseiten) |
| 9 | Der Titel und die Beschreibung werden verfasst, nicht aus der H1 ausgelesen | Automatisch durchgesetzt |
| 10 | Eine Seite, auf die nichts verlinkt, wird von nichts abgerufen | Geprüft und gemeldet |
Regel 1 — Eine Seite beantwortet eine Aufgabe in der Form, die diese Aufgabe erfordert#
Ein Tutorial, eine Erklärung, eine Anleitung, eine Referenztabelle und eine FAQ sind fünf verschiedene Formen, und ihre Vermischung führt zu einer Seite, die keine Frage vollständig beantwortet. Wenn Docsbook eine Website generiert, schreibt es sie als separate Seiten mit separaten Vorgaben: Erklärungsseiten erhalten Überschriften in Form von Nominalphrasen und keine Befehle, Anleitungsseiten erhalten einen Titel in der Form „So erreichen Sie ein bestimmtes Ziel“ sowie nummerierte, zielorientierte Schritte ohne Hintergrundtheorie, und Referenzseiten erhalten eine Tabelle pro Gruppe.
Was das für einen antwortenden Agenten bedeutet. Die Engine ordnet einen Fragetyp einem Textabschnittstyp zu. Eine konzeptionelle Frage liefert bei einer Seite, deren Abschnitte aus imperativen Schritten bestehen, schlechte Ergebnisse, und eine prozedurale Frage liefert bei Fließtext, der erklärt, warum etwas so ist, ebenfalls schlechte Ergebnisse. Die Anleitungsform hat in Docsbook eine zweite, mechanische Konsequenz: Eine Überschrift, die mit „So“ beginnt, gefolgt von einer nummerierten Liste aus drei oder mehr Schritten, entspricht genau dem, was der HowTo-Detektor liest. Die korrekte Form erzeugt somit auch das Markup — siehe Strukturierte Antworten.
Beleg. Googles Selbstbewertung für hilfreiche Inhalte fragt, ob „die Hauptüberschrift oder der Seitentitel eine beschreibende, hilfreiche Zusammenfassung des Inhalts bietet“ und separat, ob sie „Übertreibungen oder schockierende Formulierungen vermeidet“ (Google, hilfreiche Inhalte erstellen). Ein Seitentitel, der eine einzige Aufgabe benennt, erfüllt beides per Konstruktion. Die Aufteilung in fünf Formen ist die eigene Praxis von Docsbook; keine öffentliche Quelle misst sie.
Nur empfohlen. Die Formen sind in den Seitenvorgaben enthalten, denen der Generator folgt. Nichts überprüft eine handgeschriebene Seite anhand dieser Vorgaben.
Regel 2 — Formuliere die Überschrift als die Frage, die der Leser eingegeben hat#
Nicht „Ratenbegrenzung“, sondern „Was passiert, wenn ich das Ratenlimit erreiche?“. Verwende die Worte des Lesers, nicht die interne Bezeichnung für das Subsystem.
Was das für einen Antwortagenten bedeutet. Der Fragetext wird in das Dokument aufgenommen. Das Retrieval bewertet die Ähnlichkeit zwischen einer Frage und einer Passage, und der einfachste Weg, diesen Wert zu erhöhen, besteht darin, dass die Passage die Frage enthält. Dies ist derselbe Effekt, den die Dokumenterweiterung gezielt nutzt: Nogueira et al. sagen voraus, „welche Anfragen für ein bestimmtes Dokument gestellt werden“, und hängen diese an das Dokument an. Dabei berichten sie vom „Stand der Technik bei zwei Retrieval-Aufgaben“, wobei allein das Retrieval beinahe die Leistungsfähigkeit deutlich teurerer neuronaler Re-Ranker erreicht (arXiv 1904.08375). Eine Frage als Überschrift ist genau diese Erweiterung, verfasst von der Person, die bereits weiß, welche Frage der Abschnitt beantwortet. In Docsbook ist sie außerdem eine Eingabe für den Detektor — eine ###-Überschrift, die mit einem Fragezeichen endet, wird zu einem Question im FAQPage-Markup.
Beleg. arXiv 1904.08375 sowie der oben beschriebene Mechanismus. Beachten Sie, was keine Quelle belegt: Nichts Veröffentlichtes sagt, dass eine Frage als Überschrift Ihnen ein Featured Snippet verschafft. Auf die Frage, wie man eine Seite als solches kennzeichnet, antwortet Google: „Das können Sie nicht. Die Google-Systeme bestimmen, ob eine Seite ein gutes Featured Snippet für die Suchanfrage eines Nutzers wäre, und heben sie gegebenenfalls hervor“ (Google, Featured Snippets).
Nur empfohlen. Die Schreibagenten formulieren Überschriften auf diese Weise; nichts schreibt eine von Ihnen verfasste Überschrift um.
Regel 3 — Jeder Abschnitt muss ohne etwas darüber lesbar sein#
Ein Abschnitt, der mit „Wie oben erwähnt, ist dies standardmäßig auf 30 Sekunden eingestellt“ beginnt, ist unbrauchbar, sobald er von dem Absatz getrennt wird, auf den er sich bezieht — und das wird bereits beim ersten Abruf geschehen.
Auswirkungen auf einen antwortenden Agenten. Docsbook indiziert Ihre Dokumentation standardmäßig auf Überschriftenebene: eine eingebettete Einheit pro Abschnitt, nicht pro Seite. Der eingebettete Text jeder Einheit wird mit dem vollständigen Breadcrumb der Abschnittsüberschrift vorangestellt — Billing > Refunds > Limits — und zwar genau deshalb, weil ein Abschnitt namens „Limits“ unter Webhooks etwas anderes bedeutet als unter AI-Chat und der Vektor diese Information enthalten muss. Einheiten sind auf 6.000 Zeichen begrenzt; ein längerer Abschnitt wird abgeschnitten, sodass eine am Ende eines sehr langen Abschnitts verborgene Tatsache überhaupt nicht im Vektor enthalten ist. Auf Zeilenebene werden Absatzblöcke mit höchstens 20 Zeichen als Rauschen verworfen.
Belege. Die Granularität des Abrufs ist eine messbare Variable, und feinere, in sich geschlossene Einheiten schneiden besser ab. Chen et al. vergleichen Dokument-, Absatz- und Satzeinheiten mit „Propositionen“ — „atomaren Ausdrücken innerhalb eines Textes, die jeweils ein eigenständiges Faktum enthalten und in einer prägnanten, in sich geschlossenen Sprache präsentiert werden“ — und berichten, dass „die Indizierung eines Korpus anhand feingranularer Einheiten wie Propositionen bei Abrufaufgaben die Einheiten auf Absatzebene deutlich übertrifft“ (Dense X Retrieval, arXiv 2312.06648). Die entsprechende Erkenntnis auf Anbieterseite sowie der Fehlermodus, den sie bei Texten hervorruft, die ihr eigenes Thema nicht benennen, wird unter Zitationssignale beschrieben.
Automatisch erzwungen — für die Hälfte, für die Docsbook zuständig ist. Das Präfix mit dem Breadcrumb, die Einheitengrenze und die Begrenzung werden auf jede Seite angewendet, ohne dass es eine Einstellung gibt, mit der sie geändert werden können. Die andere Hälfte liegt in Ihrer Verantwortung: der Text. Nichts kann ein Thema wiederherstellen, das Sie nicht benannt haben.
Regel 4 — Überschriftenebenen sind ein Vertrag, keine Stilentscheidung#
Verwenden Sie H2 für einen Abschnitt, H3 für eine darin enthaltene Frage, und überspringen Sie keine Ebene, um eine kleinere Schrift zu erhalten.
Was das für einen Antwort-Agenten bedeutet. Zwei Dinge. Der Überschriftenbaum teilt Ihre Seite in die Einheiten aus Regel 3 auf. Wenn Sie eine Ebene überspringen, wird ein Abschnitt dem falschen übergeordneten Element zugeordnet und erhält für seinen Vektor den falschen Breadcrumb. Außerdem erkennt Docsbooks FAQ-Detektor genau eine Struktur: einen H2-Abschnitt, dessen untergeordnete H3-Elemente die Fragen sind, oder ein beliebiges H3-Element, das mit einem Fragezeichen endet. Ein FAQ mit H3-Abschnitten und H4-Fragen erzeugt überhaupt kein Markup — stillschweigend —, der häufigste AEO-Fehler, den wir sehen.
Beleg. „Überschriften vermitteln die Organisation des Inhalts auf der Seite. Webbrowser, Plug-ins und unterstützende Technologien können sie verwenden, um die Navigation innerhalb der Seite zu ermöglichen“, und „Das Überspringen von Überschriftenebenen kann verwirrend sein und sollte nach Möglichkeit vermieden werden: Stellen Sie sicher, dass ein <h2> nicht direkt von einem <h4> gefolgt wird“ (W3C WAI, Überschriften).
Nur empfohlen, und genau hier besteht eine echte Lücke: Nichts in Docsbook warnt Sie davor, dass Sie eine Ebene übersprungen haben oder dass Ihr FAQ-Abschnitt keine Übereinstimmung erzielt hat. Überprüfen Sie dies mit einem Validator — siehe Strukturierte Antworten.
Regel 5 — Der Überschriftentext bestimmt seinen Anker; niemals einen von Hand schreiben#
Tiefe Links, Suchergebnisse und KI-Zitate verweisen alle auf page#anchor. Jeder dieser Anker wird aus dem Überschriftentext von derselben Bibliothek abgeleitet, die auch der Renderer verwendet, und kein anderer Code darf einen solchen Anker erraten.
Was das für einen Antwortagenten bedeutet. Ein Zitat, dessen Anker nicht existiert, führt den Leser an den Anfang einer langen Seite, obwohl ihm ein bestimmter Abschnitt versprochen wurde. Es wird kein Fehler ausgelöst; der Link ist einfach falsch. Docsbook berechnet Anker durch den Aufruf von github-slugger, was rehype-slug beim Rendern der Seite verwendet, sodass der vorberechnete Anker und das gerenderte id nicht voneinander abweichen können. Bevor dies zentralisiert wurde, wurde ein selbst entwickelter Slugifier am eigenen Korpus dieses Repositorys gemessen: 1.386 von 21.827 Überschriften — 6,3 % — erzeugten einen Anker, der nicht der ID auf der Seite entsprach, und 263 ergaben ausschließlich Bindestriche. 314 der Abweichungen betrafen Überschriften in reinem ASCII („Edge cases & errors“ lässt einen Separator zu viel weg); der Rest betraf nicht-lateinische Schriftzeichen, bei denen jede Überschrift einer russischsprachigen Website auf denselben ungültigen Anker zusammenfiel.
Beleg. Die oben genannte Messung stammt aus diesem Repository, nicht aus einer veröffentlichten Studie; betrachten Sie sie als unsere eigene Zahl. Es gibt dafür keine externe Quelle, und es ist auch keine erforderlich — die Regel lautet, dass eine Zeichenfolge mit einem Besitzer diesen gefragt und nicht erneut abgeleitet wird.
Automatisch erzwungen. Anker werden für jeden Verbraucher an einer einzigen Stelle berechnet.
Regel 6 — Die Antwort muss in den Bytes enthalten sein, bevor JavaScript ausgeführt wird#
Wenn der Fließtext erst erscheint, nachdem ein Browser ein Skript ausgeführt hat, erhält ein Assistent, der die URL abruft, nur ein Gerüst.
Was das für einen Antwortagenten bedeutet. Überhaupt nichts — und genau das ist der Punkt. Dieser Fehler bleibt bei jeder Prüfung unsichtbar, die Ihr Markdown liest, denn mit dem Markdown ist alles in Ordnung. Docsbooks audit_geo ruft stichprobenartig Seiten ohne JavaScript-Engine ab und prüft, ob nach dem Entfernen der Tags mindestens 200 Wörter Fließtext erhalten bleiben; darunter wird die Seite als kritischer Befund gemeldet, mit der Begründung, dass Navigationsbeschriftungen, ein Cookie-Banner und ein title-Tag allein eine niedrigere Schwelle überschreiten können. Dieselbe Prüfung wird auch mit den User-Agents benannter Assistenten durchgeführt, sodass ein CDN, das einem Browser eine Seite und einem Assistenten eine Challenge ausliefert, als separater Befund sichtbar wird.
Belege. Googles Leitlinien für AI Overviews und AI Mode stellen ausdrücklich klar, dass die Lösung in Textinhalten liegt, nicht im Markup: „Sicherstellen, dass wichtige Inhalte in Textform verfügbar sind“, zusammen mit „Sicherstellen, dass Crawling in der robots.txt erlaubt ist“ — und im selben Dokument: „Sie müssen keine neuen maschinenlesbaren Dateien, KI-Textdateien oder Markups erstellen, um in diesen Funktionen zu erscheinen“ (Google, KI-Funktionen). Perplexity beschreibt Perplexity-User als das Aufrufen einer Seite, wenn ein Benutzer eine Frage stellt, um „dabei zu helfen, eine genaue Antwort bereitzustellen und einen Link zur Seite in die Antwort aufzunehmen“ (Perplexity, Bots) — ein Abruf ohne Browser.
Geprüft und gemeldet. Die eigenen Seiten von Docsbook werden serverseitig gerendert, daher besteht eine von Docsbook gehostete Website diese Prüfung konstruktionsbedingt; die Prüfung existiert für die Websites, die Docsbook auditiert.
Regel 7 — Jede Zahl in einer Behauptung benennt das, was sie hervorgebracht hat#
Ein Satz, der eine Zahl enthält, muss auf die Beobachtung zurückführbar sein, die diese Zahl hervorgebracht hat — nicht auf eine plausible Erinnerung daran.
Was dies für einen antwortenden Agenten bedeutet. Eine falsche Zahl ist der einzige Fehler, der eine Korrektur überlebt: Ein Assistent wiederholt sie, und die Wiederholung überdauert Ihre Bearbeitung. Docsbook setzt dies bei allem durch, was seine Agentenwerkzeuge ausgeben. Jeder Befund enthält evidence_refs, das auf benannte Evidenzeinträge verweist, und der Vertragsvalidator durchsucht den Text des Befunds selbst nach Ziffern: Jede Zahl, die nicht in der von ihr zitierten Evidenz vorkommt, stellt einen Verstoß dar, und die Nutzlast wird zur Reparatur an das Modell zurückgesendet, statt an Sie zurückgegeben zu werden. Die einzigen Ausnahmen sind die einzelnen Ziffern 0–9 sowie 10 und 100 — Ordnungszahlen und kleine Anzahlen innerhalb gewöhnlicher Prosa. Die Bewertung erfolgt durch einfachen Code anhand der gesammelten Evidenz und nicht durch das Modell, weil eine von einem Sprachmodell geschriebene Zahl von 0–100 nicht mit derselben Zahl vergleichbar ist, die dasselbe Modell in der nächsten Woche schreibt.
Evidenz. Googles Fragen zu hilfreichen Inhalten fragen, ob „der vorhandene Inhalt Informationen auf eine Weise präsentiert, die Vertrauen weckt, etwa durch klare Quellenangaben und Belege für die vorhandene Expertise“ (Google, hilfreiche Inhalte erstellen). Die gemessene Version — dass das Hinzufügen von Statistiken und die Angabe von Quellen den Anteil einer generierten Antwort erhöht, der Ihnen zugeschrieben wird — findet sich unter Zitationssignale, wo diese Effektstärken dokumentiert sind.
Automatisch durchgesetzt, für Agentenausgaben. Eine Zahl, die Sie selbst in eine Seite eingeben, wird von nichts überprüft.
Regel 8 — Preise, Limits und Versionen werden kopiert, nie abgeleitet#
Jeder Preis und jedes angegebene Limit auf einer generierten Seite wird wortwörtlich aus dem in diesem Durchlauf gelesenen Ausgangsmaterial übernommen. Ein Tarif, dessen Preis nicht in der Quelle enthalten ist, wird als „Vertrieb kontaktieren“ angegeben.
Was das für einen antwortenden Agenten bedeutet. Die Preisgestaltung ist die am häufigsten zitierte Tatsache über ein Produkt und diejenige, auf die ein Leser reagiert. Ein abgeleiteter „typischer“ Preis ist nicht von einem echten zu unterscheiden, sobald ein Assistent ihn wiederholt. Der Generator von Docsbook führt diese Regel im Briefing mit, und die anonyme Pipeline geht noch weiter: Wenn bei einem Crawl überhaupt keine Preise gefunden wurden, wird die Preisseite nicht erstellt, aus dem Grund, dass eine Preisseite mit geratenen Zahlen schlechter ist als gar keine Preisseite.
Belege. Googles Richtlinie für strukturierte Daten verlangt, dass Markup „eine wahrheitsgetreue Darstellung des Seiteninhalts“ ist, und verbietet es, Inhalte zu markieren, die für Leser nicht sichtbar sind (Google, Richtlinien für strukturierte Daten); Googles Leitfaden zu KI-Funktionen fordert, dass „strukturierte Daten mit dem sichtbaren Text auf der Seite übereinstimmen“ (Google, KI-Funktionen). Nichts davon sagt etwas über erfundene Preise aus — dieser Teil ist Docsbooks eigene Regel, und wir stellen sie als unsere dar.
Automatisch durchgesetzt für die generierte Preisseite, die verworfen statt geraten wird. An anderer Stelle ist sie eine Anweisung im Briefing.
Regel 9 — Der Titel und die Beschreibung werden verfasst, nicht aus der H1 extrahiert#
Frontmatter title hat Vorrang vor der H1 im Text, diese vor dem Dateinamen. Frontmatter description hat Vorrang vor dem ersten Absatz im Text.
Auswirkung auf ein antwortendes System. Der Titel und die Beschreibung sind die beiden Zeichenfolgen, die eine Maschine liest, bevor sie irgendetwas anderes liest, und beide haben einen Fehlerfall, der auf der Seite unsichtbar ist. Wenn der Titel aus der H1 abgeleitet wird, bewirkt die Bearbeitung des Frontmatters durch einen Autor zur Steuerung des Suchergebnisses keine Änderung, und der Markenname kann zweimal angehängt werden — wodurch ein Drittel der Zeile eines Suchergebnisses für Wiederholungen verloren geht. Wenn die Beschreibung aus dem Textkörper abgeleitet wird, können Widget-Markup und die Überreste einer Kartenliste in den dem Leser angezeigten Text durchsickern. Docsbook legt die Rangfolge an einer Stelle fest und kürzt an einer Wortgrenze, wobei an einem Satzende gekürzt wird, sofern eines verfügbar ist: 160 Zeichen für <meta name="description"> und 400 für Open Graph und das JSON-LD-description, beide aus derselben verfassten Zeichenfolge befüllt, sodass sie niemals voneinander abweichen können.
Belege. „Snippets werden in erster Linie aus dem Seiteninhalt selbst erstellt“, und Google empfiehlt „einzigartige Beschreibungen für jede Seite“ (Google, Snippet). Für Titel gilt: Schreiben Sie „beschreibenden und prägnanten Text“, vermeiden Sie „wiederholten oder vorgefertigten Text“ und „kennzeichnen Sie Ihre Titel prägnant“ (Google, Titel-Link).
Automatisch durchgesetzt für die Rangfolge und die Kürzung. Die Längen sind das eigene Limit von Docsbook, keine veröffentlichte Begrenzung — siehe Grenzwerte.
Regel 10 — Eine Seite, auf die niemand verlinkt, wird von niemandem abgerufen#
Jede Seite sollte von mindestens einer anderen Seite aus erreichbar sein, und jeder Link darauf sollte funktionieren.
Was das für einen Antwortagenten bedeutet. Crawler finden Seiten, indem sie Links folgen; eine Seite, die nur in der Sitemap existiert, ist eine Seite, für deren Abruf ein Crawler nur einen schwachen Grund hat und die er nicht als wichtig betrachten kann. Docsbook erstellt einen Link-Graphen über den gesamten Dokumentbestand und zählt pro Seite eingehende Links und nicht auflösbare Links. Eine Seite mit fehlerhaften Links oder ohne eingehende Links wird auf der Doc-Graph-Karte markiert, wobei die Behebung als Aktion angeboten wird.
Beleg. Googles Liste dessen, was tatsächlich dazu beiträgt, dass eine Seite in KI-Übersichten und im KI-Modus erscheint, enthält „Ihre Inhalte durch interne Links auf Ihrer Website leicht auffindbar machen“ (Google, KI-Funktionen).
Überprüft und gemeldet. Nichts fügt für Sie einen Link hinzu, es sei denn, Sie bitten einen Agenten darum.
Grenzen und offene Fragen#
- Die Hälfte der Liste hält dich nicht davon ab, das Falsche zu tun. Die Regeln 1, 2 und 4 sind Anweisungen, die die Schreibagenten beim Erstellen befolgen; die Regeln 6 und 10 werden nachträglich gemeldet; Regel 8 wird nur auf der generierten Preisseite strikt durchgesetzt. Wenn du eine Seite von Hand schreibst — oder eine von einem Agenten geschriebene Seite bearbeitest — prüft nichts in Docsbook sie gegen diese Liste. Einen Linter, der übersprungene Überschriftenebenen und FAQ-Abschnitte meldet, auf die kein Detektor zutrifft, gibt es noch nicht, und Regel 4 ist die Regel, die am häufigsten und am unauffälligsten fehlschlägt.
- Die Zeichenbudgets in Regel 9 stammen von uns, nicht von Google. Google veröffentlicht überhaupt kein Zeichenlimit: „es gibt keine Begrenzung dafür, wie lang ein
<title>-Element sein kann“, und der Titellink „wird in den Google-Suchergebnissen nach Bedarf gekürzt, typischerweise so, dass er in die Gerätebreite passt“ (Google, Titellink). Dasselbe gilt für Beschreibungen. 160 und 400 sind die Budgets, die diese Codebasis verwendet, und das Ziel von 50–60 Zeichen für den Titel sowie 130–160 Zeichen für die Beschreibung in den Briefings des Generators entsprechen unserem Stil. Betrachte sie als sinnvolle Standardwerte, nicht als Schwellenwerte, an denen irgendetwas dich misst. - Offene Frage: der Schwellenwert für zu dünne Seiten. Der Code von Docsbook berechnet ein seitenbezogenes Ergebnis, das eine Seite mit weniger als 120 Wörtern als „thin“ bezeichnet, neben „broken“ und „orphan“. Die Ergebnisse für defekte Links und verwaiste Seiten werden angezeigt; das Ergebnis „thin“ wird berechnet, exportiert und durch Unit-Tests geprüft, aber derzeit auf keinem Panel dargestellt. In der Praxis wird dir also nicht mitgeteilt, dass eine Seite zu dünn ist. Die Mindestwortzahlen in den Briefings des Generators — je nach Seitentyp 300 bis 400 Wörter — entsprechen unserem Stil; eine veröffentlichte Quelle für genau diese Zahlen gibt es nicht. Belegt ist nur die Richtung: Google fragt, ob Inhalte „im Vergleich zu anderen Seiten in den Suchergebnissen einen wesentlichen Mehrwert bieten“ (Google, hilfreiche Inhalte erstellen).
- Offene Frage: ob Überschriften in Frageform die Zitierungsrate erhöhen. Der in Regel 2 beschriebene Abrufmechanismus ist real und belegt. Keine öffentliche Quelle belegt jedoch einen Anstieg der Zitierungsrate, der speziell auf die Form der Überschrift zurückzuführen ist — und zwar bei keiner Antwortmaschine. Die Dokumenterweiterung wird anhand von Abruf-Benchmarks gemessen, nicht anhand von ChatGPT oder AI Overviews. Betrachte Regel 2 beim Abruf als gut begründet, bei der Zitierung jedoch als unbewiesen, bis jemand die zweite Messung veröffentlicht.
- Die Regeln 3 und 6 beschreiben zwei verschiedene Pipelines, und das Bestehen der einen sagt nichts über die andere aus. Regel 3 ist Docsbooks eigener semantischer Index über dein Markdown; Regel 6 beschreibt, was ein externer Assistent erhält, wenn er deine URL abruft. Eine Seite kann für deine On-Site-Suche perfekt in Abschnitte aufgeteilt und für ChatGPT unsichtbar sein — oder umgekehrt. Sie verwenden keinen gemeinsamen Code.
- Nichts davon wird an deinen Ergebnissen gemessen. Docsbook kann dir mitteilen, dass eine Seite verwaist ist, dass die Form eines Abschnitts zu keinem Detektor gepasst hat oder dass ein Abruf keinen Fließtext zurückgegeben hat. Es kann dir nicht sagen, dass du durch die Befolgung dieser Regeln zitiert wurdest, und das behauptet es auch nicht — siehe Zitierungssignale, um zu erfahren, warum ein einzelner Durchlauf nichts beweist, sowie Wie Docsbook seine Behauptungen belegt für den Maßstab, an dem diese Seiten gemessen werden.
Verwandte Inhalte#
- AEO — was eine Antwortmaschine von einer Seite benötigt und was das Markup noch bewirken kann
- Strukturierte Antworten — die Detektoren, die diese Regeln versorgen, und wie ein Fehler aussieht
- Zitationssignale — die gemessenen Effektstärken und was man nicht tun sollte
- GEO — der TL;DR-Block, das sichtbare Datum und die Autorenzeile
- SEO — Indexierung, kanonische URLs und Crawlbarkeit, die Phase vor all dem
- Suche — der On-Site-Abruf, den die Chunking-Regel versorgt
- Inhalts-Widgets — die Schritt- und Akkordeonbereiche, die die Detektoren verstehen
- Wie Docsbook seine Behauptungen belegt — die Belegregel, der diese Seiten folgen