Qu'est-ce que le contrôle de version pour les documents, les SOP et les…

En bref

• Contrôle de version = une version actuelle, un historique complet de toutes les précédentes et un enregistrement de qui a modifié quoi : même idée pour les documents que pour le code.
• Le contrôle des révisions est la même pratique sous un nom différent ; le contrôle des modifications et le contrôle des documents sont des processus plus larges qui les utilisent comme une seule partie.
• QueryChart conserve déjà cet historique pour chaque graphique : un journal des modifications, une vue Comparer les versions et une restauration en un clic : voir /features/version-control.
• La version mineure d'un brouillon (0.1, 0.2…) se déplace à chaque cycle de révision ; une version majeure complète n'est attribuée qu'une seule fois, lors de l'approbation formelle.
• Versionner un objet spécifique ? Voir /fr/guides/comment-controler-la-version-d-une-sop, /fr/guides/comment-controler-la-version-d-un-document ou /fr/guides/controle-de-version-d-organigramme-comment-cela-fonctionne-reellement.

Une version actuelle, tout le reste appartient à l'histoire

Recherchez « qu'est-ce que le contrôle de version » et presque tous les résultats supposent que vous gérez le code source : commits, branches, Git. Cette page concerne l'utilisation plus ancienne et plus simple de l'expression : contrôle des versions de documents, de procédures opérationnelles standard et de processus métier, pas de code. L’idée sous-jacente ne change pas entre les deux : une version actuelle faisant autorité ; un historique complet de chaque version qui l'a précédée ; et un enregistrement précisant exactement qui a changé quoi et quand. Seul l'objet en cours de versionnage est différent : de la paperasse au lieu d'une base de code.

Concrètement, cela signifie que chaque modification d'un document produit une nouvelle version numérotée plutôt que d'écraser la précédente, de sorte que la version précédente reste récupérable plutôt que disparue. Dans QueryChart, cela existe déjà pour chaque graphique que vous créez : un journal des modifications enregistre qui a modifié quel champ et ce qui a été modifié, une vue Comparer les versions définit deux révisions côte à côte, et la restauration d'une ancienne est une action unique plutôt qu'une re-saisie ; voir /features/version-control pour une image complète. Rien de tout cela ne doit être activé ; il s'exécute sur chaque graphique à partir du moment où il est créé.

Le contrôle de révision et le contrôle de version sont la même idée sous deux noms : les termes sont utilisés de manière interchangeable dans la plupart de ce domaine, et rien de significatif ne dépend de celui que votre organisation préfère. Le contrôle des modifications et le contrôle des documents sont une autre affaire : il s'agit de processus de gouvernance plus larges qui utilisent le contrôle de version comme un mécanisme, et non comme un synonyme. Un processus de contrôle des modifications (voir /fr/guides/comment-creer-un-processus-de-controle-des-changements) décide si une modification doit avoir lieu (impact, approbation, restauration) et le contrôle de version est simplement la façon dont le résultat approuvé est numéroté et enregistré par la suite. Un processus de contrôle de document (/fr/templates/organigramme-du-processus-de-controle-des-documents et le mode d'emploi sur /fr/guides/comment-creer-un-processus-de-controle-des-documents) régit l'ensemble du cycle de vie d'un document (rédiger, réviser, approuver, publier et retirer la copie remplacée de chaque endroit où il a vécu) avec le contrôle de version comme une clause à l'intérieur de celui-ci, et non dans son intégralité. Les trois paires bénéficient chacune d'une comparaison complète sur /fr/guides/controle-de-version-vs-controle-de-modification-quelle-est-la-difference, /fr/guides/controle-de-version-vs-gestion-de-documents et /fr/guides/controle-de-revision-vs-controle-de-version-quelle-est-la-vraie-difference ; cette page a seulement besoin que vous voyiez qu'il ne s'agit pas de quatre mots pour la même chose.

Si vous savez déjà lequel de ces objets vous versionnez, la réponse générale ci-dessus est moins utile que la réponse spécifique : voir /fr/guides/comment-controler-la-version-d-une-sop pour les procédures opérationnelles standard, /fr/guides/comment-controler-la-version-d-un-document pour les documents contrôlés en général, ou /fr/guides/controle-de-version-d-organigramme-comment-cela-fonctionne-reellement si ce que vous versionnez est la carte de processus elle-même. Tout ce qui suit (la définition en miniature, la procédure pas à pas, le mode d'emploi) est le cas général sur lequel ces trois éléments s'appuient.

Comment cela fonctionne

1. Choisissez un emplacement comme version faisant autorité

   Toute autre copie (un PDF envoyé par courrier électronique, une impression, une page enregistrée sur un lecteur partagé) est une copie de cet emplacement, et non un deuxième original. Si deux emplacements peuvent tous deux prétendre être à jour, vous n'avez pas encore de contrôle de version, quelle que soit l'apparence de votre numérotation.

2. Séparer la numérotation des brouillons de la numérotation publiée

   Use decimals for anything still in review and reserve whole numbers for what has actually been approved, the way 0.1 through 0.3 lead up to 1.0 in the example chart above. Un critique citant « les commentaires sur 0.3 » est alors sans ambiguïté sur le brouillon dont ils parlent.

3. Enregistrez qui a changé quoi, pas seulement ce qui a changé

   Un horodatage à lui seul ne dit rien au lecteur sur ce qui a réellement bougé. Record the actor, the field, and the before-and-after value for every edit, which is what QueryChart's Change Log does automatically for every chart, with no setup required.

4. Rendre deux versions comparables, pas seulement visibles

   Pouvoir ouvrir la version 3 et ouvrir la version 5 n'est pas la même chose que pouvoir voir ce qui a changé entre elles. La vue Comparer les versions de QueryChart définit deux révisions côte à côte afin que la différence soit la chose que vous regardez, pas une supposition.

5. Considérez la restauration d'une ancienne version comme une routine et non comme une urgence

   Si annuler une mauvaise modification signifie demander à une personne ayant accès à la base de données d'intervenir, votre contrôle de version n'existe que sur papier. La restauration d'une version antérieure devrait être une action que tout éditeur autorisé peut entreprendre lui-même, dès qu'il remarque le problème.

Erreurs à éviter

• Un nom de fichier remplaçant un numéro de version

  "SOP_v2_FINAL_reviewed(1).docx" is not a version scheme, it is a filename that happens to contain digits: nothing enforces that the number goes up, or that two people don't produce their own "FINAL" at once. Une version doit résider dans un système qui l'attribue, et non dans ce qu'une personne tape avant de l'enregistrer.

• Un historique qui enregistre uniquement l'état actuel

  Écraser un document en place et appeler l'ancienne copie « sauvegardée quelque part » n'est pas un historique de version, c'est un espoir. Un véritable historique permet à chaque version antérieure de pouvoir être récupérée et comparable, et pas seulement récupérable par quelqu'un qui se souvient de l'endroit où il l'a placée.

• Traiter "a un numéro de version" comme "est sous contrôle"

  Un numéro sur un document vous indique qu'il a été versionné une fois ; il ne vous dit pas que l'ancienne copie a été retirée, que quelqu'un a approuvé le changement ou que le numéro signifie même ce que vous pensez qu'il signifie. Le contrôle de version est la numérotation et le journal : le contrôle des documents et le contrôle des modifications sont ce qui régit le processus qui l'entoure.

• Renommer le vocabulaire au lieu de figer la pratique

  Standardising your organisation on "revision control" over "version control", or the reverse, changes nothing about whether changes are actually tracked. C'est la même pratique sous deux noms ; le correctif qui compte est le journal, pas l'étiquette.

Questions fréquentes

Le contrôle de version est-il la même chose que le contrôle de révision ?

Oui, en pratique. Les deux termes désignent la même idée : une version en vigueur et un historique consultable des versions précédentes. Les organisations, les outils et les normes privilégient simplement des mots différents. Le fonctionnement reste le même ; voir /fr/guides/controle-de-revision-vs-controle-de-version-quelle-est-la-vraie-difference pour la comparaison détaillée.

Quelle est la différence entre le contrôle de version et le contrôle des modifications ?

La gestion des changements décide si une modification doit avoir lieu, qui l'approuve, quel est son impact et comment revenir en arrière. La gestion des versions enregistre ensuite le résultat : nouveau numéro, date et auteur. Sans historique des versions, une décision de changement est difficile à retracer ; sans gestion des changements, numéroter les versions ne garantit pas que la modification était justifiée. Voir /fr/guides/controle-de-version-vs-controle-de-modification-quelle-est-la-difference et /fr/guides/comment-creer-un-processus-de-controle-des-changements.

Le contrôle de version fonctionne-t-il de la même manière pour les documents que pour le code ?

Le principe est le même : une version de référence, l'historique complet et la trace des modifications. Les mécanismes diffèrent toutefois. Pour le code, Git gère le branchement et la fusion de travaux simultanés. Pour les documents et les processus, le parcours est souvent linéaire : un brouillon passe en révision puis devient une version approuvée, comme dans le schéma de cette page.

La piste d'audit de QueryChart est-elle activée par défaut ?

L'historique des versions décrit ici (journal des modifications, comparaison et restauration) est gratuit et fonctionne automatiquement pour chaque graphique. La piste d'audit de conformité de QueryChart, fondée sur un chaînage de hachages et associée à des contrôles ISO 27001, SOC 2 et HIPAA, est une fonctionnalité payante distincte qu'une organisation active volontairement. Elle n'est pas activée par défaut.