Bewährte Praxis · Revisionen

Bewährte Praxis für die Versionierung von KI-Dokumenten

KI-Arbeit ändert sich schnell, doch Lesende brauchen weiterhin eine stabile Identität und historische Evidenz. Gutes Versionieren trennt den aktuellen formalen Stand von der genau geprüften oder zitierten Revision.

Aktualisiert 3. August 2026Praxisleitfaden

Definieren, was die Identität bedeutet

Eine kurze Aussage zu Thema, Verantwortlichkeit, Leseraufgabe und Evidenzgrenze schreiben. Sie entscheidet, ob eine Änderung noch in dieselbe Veröffentlichung gehört.

Ergänzen statt überschreiben

Ein formales --update bringt die kanonische Revision voran, bewahrt aber feste Versionslinks sowie die zugehörigen Paket- und PDF-Darstellungen.

ow publish ./artifact/document.mdw --update <document_id> --review --no-open

Jede URL für ihr Versprechen nutzen

  1. kanonische URL: aktueller formaler Stand
  2. Versionslink: Freigabe, Audit, Zitat oder Release-Evidenz
  3. versioniertes PDF: unveränderlicher Offline-Anhang
  4. typisiertes .mdw: reproduzierbare Fortsetzung und Wiederherstellung durch Agents

Bei Bedeutungswechsel eine neue Identität starten

Wechseln Eigentümerschaft, Thema, Publikum, Entscheidung oder Evidenzgrenze wesentlich, braucht es ein neues Dokument. Eine etablierte URL nicht nur wegen ihrer Aufmerksamkeit wiederverwenden.

FAQ

Häufige Fragen

Braucht ein regelmäßiger Bericht jedes Mal eine neue URL?

Meist nicht. Wenn Thema und Lesevertrag gleich bleiben, eine kanonische Identität behalten und Revisionen ergänzen.

Kann eine spätere Revision einen alten Versionslink verändern?

Nein. Ein Versionslink bezeichnet genau eine unveränderliche veröffentlichte Revision.

Echten Workflow nutzen

Veröffentliche, was dein Agent erschafft.

Gib jedem Bericht, Dokument oder Plan eine lesefertige Seite, über die Kommentare, Entscheidungen und formale Revisionen zurückfließen.