SEO-, Metadaten- und AIO-Optimierungsrichtlinie

Entscheidung

• Ad-hoc-Metadatenausgaben pro Seite werden untersagt; die Ausgabe wird in einer gemeinsamen Ebene zentralisiert (dedizierte Head-Verantwortung unter Layout).
• Für indexierbare Seiten dürfen title, description, canonical, hreflang und og:url einander nicht widersprechen.
• Open-Graph- und Twitter-Metadaten sind für teilbare Seiten verpflichtend; Bild-URLs müssen absolut sein.
• noindex wird nur für Seiten verwendet, die absichtlich aus Suchergebnissen ausgeschlossen werden, abgestimmt mit den Regeln zur Sitemap-Aufnahme.
• Für AIO (AI Overview und ähnliche Systeme) werden keine speziellen Hacks eingesetzt; stattdessen Fokus auf klare Primärinformationen und strukturierte Daten.

Erforderliche Metadatenfelder und Regeln

Betrieb von canonical / hreflang

• hreflang nur für tatsächlich vorhandene Übersetzungsseiten ausgeben.
• Für x-default die repräsentative URL der Standardsprache (ja) verwenden.
• Kein hreflang für nicht übersetzte Sprachen ausgeben.
• Jede Sprachseite muss auf sich selbst canonicalisieren (kein sprachübergreifendes Canonical).

OGP / Twitter-Cards

• Für teilbare Seiten sind folgende Angaben verpflichtend:
  • og:type (website oder article je nach Seitentyp)
  • og:title
  • og:description
  • og:url
  • og:image (absolute URL)
  • og:image:alt
  • twitter:card (summary_large_image)
  • twitter:title
  • twitter:description
  • twitter:image
• Falls kein OGP-Bild angegeben ist, wird /brand/og.jpg als seitenübergreifendes Standardbild verwendet (die Datei wird in einem Folgetask ergänzt).

noindex / sitemap-Abgleich

• Seiten mit noindex: true müssen meta robots als noindex,nofollow ausgeben und aus der Sitemap ausgeschlossen werden.
• Für nicht-produktive Hosts wie workers.dev bleibt X-Robots-Tag: noindex aktiv.
• draft und noindex bleiben semantisch getrennt:
  • draft: nicht veröffentlichbar
  • noindex: veröffentlicht, aber absichtlich nicht in Suchergebnissen

Strukturierte Daten (Kern für AIO-Bereitschaft)

• Bestehende Person- und BreadcrumbList-Ausgaben beibehalten.
• Strukturierte Daten nach Seitentyp ergänzen:
  • Detailseiten (Blog, Release Notes, ADR): Article (bei Bedarf TechArticle)
  • Übersichtsseiten (changelog, tools usw.): CollectionPage
  • About-Seite: ProfilePage
• JSON-LD darf nur tatsächlich gerenderte Fakten enthalten; keine erfundenen Bewertungen, Zahlen oder Behauptungen.

Inhaltsprinzipien für AIO-Wiederverwendung

• Keine versteckten KI-only Texte hinzufügen. Stattdessen am Seitenanfang eine kurze, aussagekräftige Einleitung platzieren.
• Eine gültige Überschriftenhierarchie beibehalten und möglichst ein Hauptthema pro Seite behandeln.
• Begriffe, Definitionen und Abläufe innerhalb der Seite selbst erklären, statt externen Kontext vorauszusetzen.

Kontext

Die aktuelle Implementierung deckt title, description, canonical und hreflang bereits teilweise ab, aber Folgendes ist noch uneinheitlich oder fehlt:

• Einheitliche Ausgaberegeln für Open Graph und Twitter
• Betriebsregeln für noindex und Sitemap
• JSON-LD-Richtlinien je Seitentyp
• Inhaltliche und strukturelle Kriterien, die gleichzeitig für Suchergebnisse und KI-Zusammenfassungen funktionieren

Bei der bestehenden Mehrsprachenarchitektur (ja als Standard, weitere Sprachen mit Präfix) wird eine einheitliche Informationsstrategie benötigt, die sowohl Suchmaschinen als auch AI-Crawlern die Wiederverwendung erleichtert.

Optionen

• Option A: Fortfahren mit individueller Implementierung pro Seite
• Option B: Auf minimale Tags (title/description/canonical) begrenzen
• Option C: Gemeinsame Richtlinie definieren und Metadaten + strukturierte Daten zentral betreiben (gewählt)

Begründung

• Konsistenz: Verhindert Inkonsistenzen zwischen canonical/hreflang/og:url.
• Betriebssicherheit: Vermeidet fehlende Pflichtfelder bei neuen Seiten.
• Wiederverwendbarkeit: Erleichtert die Nutzung derselben Primärinformationen in Suchergebnissen, Social Cards und KI-Zusammenfassungen.
• Erweiterbarkeit: Erlaubt eine stufenweise Einführung von OGP-Automatisierung und Metadaten-Checks.

Konsequenzen

• Als Umsetzung ist eine gemeinsame SEO-Head-Verantwortung erforderlich (oder eine Erweiterung der Layout-Verantwortung).
• Für Content-Collection-Schemata müssen SEO-Felder wie ogImage und noindex einheitlich definiert werden.
• CI-Checks müssen fehlende Pflicht-Metatags, canonical/hreflang-Widersprüche und noindex-Seiten in der Sitemap erkennen.
• Erfolgskriterien:
  • 100% Abdeckung der Pflicht-Metadaten bei indexierbaren Seiten
  • 100% Übereinstimmung von canonical und og:url
  • 0 Fehler bei der Validierung strukturierter Daten