Unveränderliche Inhalte festlegen
Dieser Ablauf richtet sich an Maintainer, technische Autoren und SaaS-Dokumentationsteams mit einer bereits freigegebenen Markdown-Seite. Er erstellt keine neue Dokumentation aus Code oder PDF und veröffentlicht keine Website automatisch. Quellversion, Zielregion, Ressourcen, Renderer und Basispfad festhalten. Secrets entfernen und externe KI-Verarbeitung vor Einsendung genehmigen.
Referenzen extrahieren und Codeblöcke, Bezeichner, Befehle, Zahlen und Warnungen separat erfassen. Das Inventar garantiert nicht das Erkennen sämtlicher Spezialsyntax. Gemeinsame und lokalisierte Ziele vereinbaren. Jede Ausnahme braucht einen Verantwortlichen; API-Versionen und Pflichten dürfen durch Übersetzung nicht beiläufig wechseln.
Restaurierten Entwurf prüfen
Bei mehrsprachiger Quelle die Ausgangssprache angeben und ein genehmigtes Glossar verwenden. Der Übersetzer schützt erkannte Formen und stellt sie wieder her, garantiert jedoch nicht alle Markdown-Dialekte. Relative Ziele, Referenzdefinitionen, maskierte URLs und ungewöhnliche Codebegrenzungen direkt kontrollieren. Nach Platzhalterresten, fehlenden Abschnitten und beschädigter Syntax suchen.
Zielglossar für Varianten, Großschreibung und Abkürzungen verwenden. Bei optionaler Kontext-KI prüfen, ob sie tatsächlich lief oder lokale Regeln übernahmen. Kein Modus bestätigt vollständige Bedeutung. Gesamten Inhalt vergleichen, besonders Verneinungen, Voraussetzungen, Parameter, Tabellenzellen und Warnungen. Textdiff dient wörtlich geschützten Stellen und Änderungen zwischen Entwurf und Freigabe; ein großer zweisprachiger Diff ist kein Genauigkeitsmaß.
Referenzen mit tatsächlichen IDs abgleichen
Ziele statt bloßer Linkzahlen vergleichen. Ein geändertes Ziel verändert nicht unbedingt die Anzahl. Genehmigte Lokalisierungen sowie Kontext relativer Bilder und Seitenpfade protokollieren. Statische Prüfung ruft kein Netzwerk auf und verwendet eigene Titelregeln.
Ein erhaltenes Quellfragment kann nach Titelübersetzung ins Leere führen; sein String erzeugt keine Ziel-ID. Stabile IDs nur bei Unterstützung des Empfängers verwenden, sonst Titelabhängigkeit und Referenz gemeinsam korrigieren. Befunde an der echten Seite beurteilen, einschließlich doppelter Titel, Unicode-IDs und seitenübergreifender Anker. Vorschau hilft bei Struktur, Navigation und Ressourcen brauchen Kontexttests. Externe Verfügbarkeit separat und autorisiert prüfen.
Bearbeitbare Quelle und gekennzeichneten Beleg übergeben
Nur die genehmigte Markdown-Version exportieren. HTML ist der Browserzweig, PDF-Bündel der portable Prüfzweig, keine verpflichtende Konvertierungskette. Bündelung kann Quelle und Übersetzung in getrennten Abschnitten zeigen, erzeugt aber keine automatisch zeilengleiche zweispaltige Übersetzung. Reihenfolge und Versionen kennzeichnen.
Exakte Dateien öffnen und lange Codezeilen, Tabellen, Bilder und Zielglyphen prüfen. Vorschau, Export und Website können Markdown verschieden interpretieren. Relative Ressourcen am erwarteten Pfad mitgeben oder Änderungen genehmigen; lesbares PDF bestätigt keine Website-Navigation. Markdown, Beleg, Glossar, Quelle, Linkabgleich, offene Punkte und Freigabe außerhalb temporärer Links archivieren. Allgemeine Autorenarbeit sowie umfassende Typografie und Barrierefreiheit gehören in verwandte Abläufe.