Aide · Révisions

Mettre à jour un document OpenWiki sans changer son URL

Une publication a une identité durable, mais plusieurs révisions formelles. Le lien canonique suit ce qui est courant ; les permaliens de version, eux, ne bougent jamais.

Mis à jour 3 août 2026Documentation produit

Envoyer une mise à jour candidate

Reprenez la même discipline que pour une première publication : vérifiez, construisez, calculez le digest, puis ciblez l’identité existante. Avec une revue, le candidat ne remplace pas immédiatement la version de référence.

ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdw
ow publish ./artifact/document.mdw --update <document_id> --review --no-open

Ce qui reste stable

  1. L’URL canonique continue de désigner la publication.
  2. Chaque révision publiée conserve son propre permalien fixe.
  3. Les PDF et paquets des anciennes versions restent liés à leur révision.
  4. Un candidat ne remplace pas silencieusement la version courante avant la décision.

Reprendre le travail sur une autre machine

Récupérez le paquet typé courant puis rouvrez-le comme espace de travail. Cette voie conserve la structure ; elle évite de reconstituer un document depuis le HTML affiché.

ow pull <document_id> -o document.mdw
ow a2ui draft open document.mdw --dir ./workspace

Quand créer plutôt un nouveau document

Créez une nouvelle identité si le sujet, le lecteur attendu, le propriétaire ou le périmètre des preuves a réellement changé. Conserver une ancienne URL uniquement pour son trafic finirait par tromper le lecteur.

FAQ

Questions fréquentes

Une mise à jour casse-t-elle le lien déjà partagé ?

Non. L’URL canonique demeure stable, et chaque révision formelle reçoit en plus un permalien immuable.

Un candidat en revue peut-il remplacer la version courante avant approbation ?

Non. La révision formelle courante reste disponible tant que le candidat attend sa décision de publication.

Utiliser le vrai workflow

Publiez ce que votre Agent crée.

Donnez à chaque rapport, document ou plan une page pensée pour ses lecteurs, d’où reviennent commentaires, décisions et révisions formelles.