Redaktionsrichtlinie
Diese Richtlinie beschreibt, wie technische Guides und Tool-Dokumentation erstellt, geprüft, belegt, aktualisiert und korrigiert werden.
Zweck und Suchintention
Jede indexierte Seite soll eine eigenständige Aufgabe lösen. Konverterseiten bedienen unmittelbare Tool-Intention, Guides behandeln Vergleiche, Implementierung, Objektschlüssel oder Framework-Grenzen. Nahezu identische Seiten werden nicht erweitert, solange Nutzung oder Search Console keinen eigenständigen Bedarf zeigen.
Quellen und technische Aussagen
Für Sprachstil, Browser-APIs, Bibliotheken, Frameworks und Serialisierung bevorzugen wir Primärdokumentation. Aussagen über den eigenen Konverter werden gegen Implementierung und Tests der Website geprüft.
Verifikation und Prüfdaten
Codebeispiele und Grenzfälle sollen reproduzierbar sein. Veröffentlichungs- und Prüfdatum werden nur nach tatsächlicher Veröffentlichung oder substantieller Prüfung geändert und nicht für SEO zurückdatiert.
Korrekturen und Aktualisierungen
Wenn ein gemeldetes Problem reproduzierbar ist, werden Regel, Beispiel, Quelle oder Erklärung korrigiert und nach Möglichkeit durch einen Regressionstest abgesichert. Relevante Guides werden bei wesentlichen Änderungen der offiziellen Upstream-Dokumentation erneut geprüft.
Automatisierung und KI-Unterstützung
Automatisierung oder KI kann Entwurf, Übersetzung, Code-Review oder Qualitätssicherung unterstützen. Automatisierte Ausgabe gilt nicht als Quelle. Veröffentlichte technische Aussagen müssen weiterhin durch reproduzierbares Verhalten, Repository-Tests oder Primärdokumentation gestützt werden; Lokalisierungen werden zusätzlich auf nicht übersetzte englische Texte geprüft.