Contrôle de révision vs contrôle de version : quelle est la vraie différence ?

En bref

• « Contrôle de révision » et « contrôle de version » décrivent la même pratique ; la plupart des praticiens utilisent les deux termes de manière interchangeable sans perte de sens.
• Lorsqu’une véritable nuance existe : une révision est généralement l’entrée de modification datée individuelle, une version est généralement l’état résultant de l’ensemble du document.
• Ne créez pas deux journaux pour une seule idée : un seul historique de versions, appelé n'importe quel nom, suffit.
• L'historique des versions gratuit de QueryChart (journal des modifications, comparaison des versions, restauration) fonctionne de la même manière, quel que soit le mot préféré de votre organisation : voir /features/version-control.
• Cette nuance est particulièrement importante pour un journal des modifications autonome ; voir /fr/guides/comment-creer-un-historique-de-revision-de-document pour en construire un.

Un enregistrement, décrit de deux manières

Un responsable qualité demande si son registre doit s'intituler « journal de révision » ou « historique des versions » et obtient trois réponses confiantes et contradictoires de la part de trois collègues. Tous les trois décrivent le même document. Ce n’est pas une lacune terminologique qui mérite d’être corrigée : c’est le signe que les deux mots font un réel travail dans la même phrase, désignant simplement différentes tailles de grains de la même activité, et non deux activités différentes.

La taille des grains est la seule distinction à conserver. « Révision » est le mot le plus naturel pour désigner une modification unique datée et attribuée : la chose enregistrée dans une ligne d'un journal des modifications. "Version" est le mot le plus naturel pour désigner l'état résultant de l'ensemble du document après l'application de cette modification : la chose qu'un lecteur ouvre et lit. Une révision est une étape ; une version est l'endroit où les étapes sont arrivées. Le tableau ci-dessous est intitulé Journal de révision d'un document exactement pour cette raison : chaque ligne qu'il contient correspond à une révision, et "la version actuelle" est simplement ce qu'est le document une fois sa révision la plus récente fermée.

Il s’agit d’une question plus restreinte que les autres paires de ce groupe. Le contrôle des modifications et le contrôle des documents sont des processus véritablement plus larges qui utilisent la gestion des versions comme mécanisme interne ; voir /fr/guides/controle-de-version-vs-controle-de-modification-quelle-est-la-difference et /fr/guides/controle-de-version-vs-gestion-de-documents pour ceux-ci. Le contrôle de révision et le contrôle de version ne sont pas ce genre de paire : la plupart des praticiens, la plupart des normes et la plupart des logiciels utilisent les deux mots de manière interchangeable sans perte de sens, et l'historique des versions gratuit de QueryChart (un journal des modifications, une vue de comparaison des versions, une restauration en un clic, sur /features/version-control) fonctionne de la même manière, quel que soit le nom préféré de votre organisation.

Si la définition générale correspond à ce que vous recherchez réellement, /fr/guides/qu-est-ce-que-le-controle-de-version-pour-les-documents-les-sop-et-les-processus la couvre entièrement. Cette page suppose cette définition et répond à la question plus précise en dessous : le choix du mot est-il important et où.

Comment cela fonctionne

1. Choisissez un mot pour votre propre registre et arrêtez de le relancer

   Choisissez « journal de révision » ou « historique des versions » pour le registre de votre organisation, insérez-le dans le titre et les en-têtes de colonnes du registre, et continuez. Laisser différentes équipes se disputer dans un vocabulaire différent pour des lignes identiques fait perdre plus de temps que le choix lui-même n'en vaut la peine.

2. Donnez à chaque révision sa propre ligne, jamais un champ modifié

   Dans l'exemple de graphique, chaque révision est sa propre ligne en forme de fichier avec son propre numéro, attribué dans « Attribuer un numéro d'entrée et lier le document », plutôt qu'un compteur que vous écrasez. Construisez votre journal de la même manière : une modification est un nouvel enregistrement, pas une modification du dernier.

3. Enregistrez ce qui a changé dans l'entrée, pas seulement ce qui a changé

   "Enregistrer la description avant et après, l'auteur et la date" est la ligne qui mérite d'être copiée littéralement : nommez le champ ou la clause, son ancienne valeur, sa nouvelle valeur, qui a effectué la modification et quand. Une ligne datée qui n'indique pas ce qui a été déplacé n'est pas une entrée de révision, c'est un horodatage.

4. Vérifiez l'entrée par rapport au document avant de le fermer

   « Comparer l'entrée du journal avec la modification mise en œuvre » et son « Vérifié par rapport au document ? » la porte existe parce que les entrées et les documents dérivent : une description écrite avant la fin de la modification, ou une modification qui va plus loin que ce que dit la demande. Redirigez l'inadéquation vers le côté erroné avant de fermer la rangée.

5. Laissez le journal s'enregistrer là où le document se trouve déjà dans QueryChart

   Si le document contrôlé est lui-même un graphique QueryChart, son journal des modifications enregistre déjà qui a modifié quel champ et ce de et vers quoi, à chaque modification, sans configuration. Vous n'êtes pas obligé de gérer manuellement les lignes de révision ci-dessus sous forme de tableau séparé : voir /features/version-control.

Erreurs à éviter

• Deux journaux pour une idée

  La tenue d'un « registre de révision » distinct et d'une « feuille de calcul d'historique des versions » distincte pour le même document garantit que les deux ne seront pas d'accord la première fois que quelqu'un ne mettra à jour qu'un seul d'entre eux. Tenez un journal ; appelez-le selon le nom que votre organisation préfère.

• Traiter le débat sur le vocabulaire comme le livrable

  Une heure passée à décider si une colonne doit lire « Révision » ou « Version » est une heure non passée à enregistrer les valeurs avant et après dont un auditeur ou un collègue a réellement besoin. Choisissez l’un ou l’autre mot et enregistrez le champ.

• Ignorer la vérification, car l'entrée correspond « évidemment »

  "Vérifié par rapport au document ?" existe parce que l'entrée et le document sont parfois en désaccord : la description a été rédigée avant la fin de la modification, ou la modification est allée plus loin que la demande. Sauter le contrôle transforme le journal en une aspiration plutôt qu'en un enregistrement.

• Supprimer une mauvaise entrée au lieu de la corriger avec une nouvelle

  Une entrée de révision qui s'avère erronée doit être corrigée avec une nouvelle entrée datée qui l'indique, et non supprimée. Un journal de révision manquant de ses propres erreurs cesse d'être fiable dès que quelqu'un remarque que quelque chose est absent.

Questions fréquentes

Une « révision » est-elle la même chose qu’une « version » ?

Dans la plupart des usages, oui : les deux mots décrivent le même enregistrement sous-jacent, et basculer entre eux ne change rien à la mécanique. Lorsqu'une réelle différence apparaît, il s'agit d'une différence de grain : une révision est généralement une modification datée individuelle, et une version est généralement l'état résultant de l'ensemble du document une fois que cette modification est appliquée : dans le tableau ci-dessus, chaque ligne est une révision, et le document qui sort à l'autre extrémité est la version actuelle.

Dois-je appeler mon journal un « journal de révision » ou un « historique des versions » ?

Quel que soit votre organisation, la norme ou le logiciel utilisé : la documentation ISO 9001 indique généralement "révision", tandis que la plupart des produits SaaS indiquent "version" (QueryChart inclus, dans /features/version-control), et la cohérence au sein de votre propre registre compte bien plus que le nom que vous choisissez. N'exécutez pas les deux termes en parallèle pour le même artefact.

Cette distinction est-elle importante pour un audit ?

Pas comme les gens l’attendent. Un auditeur vérifie que chaque modification est datée, attribuée et récupérable, et non le nom qui étiquette le registre. Ce qui compte le plus, c'est de ne pas confondre le « contrôle des révisions » avec le cycle de vie complet du contrôle des documents : voir /fr/guides/comment-creer-un-processus-de-controle-des-documents pour la différence entre numéroter une modification et contrôler un document de bout en bout.

Où cette nuance importe-t-elle réellement dans la pratique ?

Le plus directement dans un journal des modifications ou un registre de révision autonome : un artefact dont le seul objectif est de répertorier les entrées individuelles datées, que la "révision" décrit plus précisément que la "version". Voir /fr/guides/comment-creer-un-historique-de-revision-de-document pour en créer un et /fr/guides/qu-est-ce-que-le-controle-de-version-pour-les-documents-les-sop-et-les-processus pour la définition plus large que suppose cette page.