Guide FluidDocs CLI : le brouillon est corrigé, mais quelle version les lecteurs voient-ils ?
Deux relevés de validation fictifs distinguent la révision enregistrée, la version accessible aux lecteurs et le texte cité dans une réponse.
FluidDocs CLI mérite d’être comparé si votre équipe met souvent à jour un document interactif régulièrement consulté et doit distinguer les révisions internes des versions destinées aux lecteurs. La documentation de la ligne de commande FluidDocs présente séparément la modification d’un brouillon et sa publication ; la présentation du lancement indique que les lecteurs peuvent poser des questions sur le contenu. Voir le nouveau texte en interne ne prouve donc pas qu’il figure dans la version prévue pour les lecteurs ni qu’une réponse s’y réfère.
Ne pas valider à la place du lecteur depuis la vue de l’auteur
Imaginons une notice non sensible de prêt de matériel de bureau. L’ancienne version indique « câble adaptateur du projecteur dans l’armoire A », et le nouveau brouillon validé en interne indique « armoire B ». La personne qui reprend la notice reçoit deux relevés fictifs : l’avis « nouveau brouillon enregistré » de l’auteur et le texte visible pour le lecteur. Si le texte dit encore A, seule la rédaction du brouillon est terminée ; ne dirigez pas les collègues vers B sur la foi d’une mise à jour interne. Si la page indique B mais que le module de questions-réponses indique encore A, consignez les deux résultats à part. Une bonne réponse ne valide pas l’autre relevé.
La fiche réelle peut tenir en trois lignes : la version que l’équipe a choisi de rendre applicable, la phrase visible pour les lecteurs et, si les questions-réponses sont activées, le texte invoqué dans la réponse. Laissez « à vérifier » tant que la vue du lecteur n’a pas été contrôlée ; ne déduisez pas le contenu public de la date d’une capture ni de l’état du brouillon dans l’interface d’administration. Cet exercice statique ne comporte ni commande exécutée, ni page créée, ni collecte de données de lecteurs.
Pour une notice qui change souvent et suscite de vraies questions de détail, séparer le suivi des brouillons de celui des publications est utile. Pour une annonce unique, ou si personne ne peut vérifier la vue du lecteur après chaque modification, envisagez d’abord un document statique dont la version est clairement indiquée.
À propos de cet article :Cet article s’appuie sur des informations publiques et sert de référence pour vous aider à choisir vos outils. Les fonctionnalités, les tarifs et les politiques associées peuvent évoluer à tout moment ; veuillez consulter les informations officielles les plus récentes.
Source originale :fluiddocs.ai