Définir ce que représente l'identité
Écrire une phrase courte qui couvre sujet, responsable, tâche du lecteur et frontière de preuve. Elle sert à déterminer si une modification appartient encore à la même publication.
Ajouter plutôt qu'écraser
Une mise à jour formelle avec --update avance la révision canonique tout en préservant les liens de version fixe et leurs représentations en paquet ou PDF.
ow publish ./artifact/document.mdw --update <document_id> --review --no-openEmployer chaque URL selon sa promesse
- URL canonique : état formel le plus récent
- permalien de version : approbation, audit, citation ou preuve de release
- PDF versionné : pièce jointe hors ligne fixe
- .mdw typé : reprise et récupération reproductibles par Agent
Créer une nouvelle identité quand le sens change
Un changement important de propriétaire, sujet, audience, décision ou frontière de preuve exige un nouveau document. Ne réutilisez pas une URL établie uniquement pour récupérer son attention.
FAQ
Questions fréquentes
Un rapport récurrent doit-il avoir une nouvelle URL à chaque fois ?
En général non. Gardez une identité canonique et ajoutez des révisions tant que le sujet et le contrat du lecteur restent les mêmes.
Une révision ultérieure peut-elle modifier un ancien permalien ?
Non. Un permalien de version identifie une seule révision publiée et immuable.
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.