Sommaire de la documentation13 / 20

Garder vos décisions13 / 20

Revenir sur chaque version

Sur cette page

Chaque modification d’un document d’intention est conservée. Choisissez une version pour voir quels documents elle a changés et ce qui a changé dans chacun, si c’est vous qui avez fait la modification ou si l’Agent l’a proposée et vous l’avez acceptée, et comment le texte était expliqué à l’époque. La façon dont vous êtes arrivé à votre décision est toujours là.

Ouvrir l’historique des versions

Il y a trois façons d’y accéder :

  • Survolez le titre « Intentions » dans la barre latérale et cliquez sur le bouton d’historique.
  • Choisissez Présentation → Historique des versions, ou appuyez sur ⌘Y (Ctrl+Y sous Windows et Linux).
  • Dans une note qui indique « Ceci explique le texte précédent », cliquez sur « Voir dans l’historique des versions ».

Les deux premières ne font que changer la barre latérale et sélectionner la dernière version ; la zone principale reste telle quelle. La troisième sélectionne la dernière version qui a modifié ce document, et remplace sur place le document actuel par cette version.

Dans l’historique, les onglets, les dispositions côte à côte, le panneau de code et les conversations de la zone principale fonctionnent comme d’habitude. Cliquez sur « Quitter l’historique des versions » en haut de la barre latérale pour revenir à la barre latérale normale ; l’onglet de l’historique se ferme avec elle.

D’où viennent les versions

Chaque modification de vos documents d’intention est une version. Selon la source, ce sont :

SourceTitre dans la liste
Vous avez accepté une propositionLe titre de la proposition, par exemple « Envoyer un e-mail au responsable de l’équipe au début de la période de grâce »
Vous avez accepté un plan d’organisationRéorganisation
Vous avez enregistré dans Noea, ou modifié les fichiers hors de NoeaModifications manuelles. Les modifications manuelles consécutives fusionnent en une seule version jusqu’à la fin du prochain Expliquer
Chaque document modifié est revenu à un état déjà enregistréRetour à « le titre de cette version »
Les documents tels qu’ils étaient au début de l’enregistrementDébut de l’enregistrement

Lire la liste des versions

Dans l’historique, la partie basse de la barre latérale devient la liste des versions, regroupées par jour, les plus récentes en premier. Chaque version occupe deux lignes : son titre, puis son heure, une icône d’état, une icône de source et le nombre de documents modifiés, par exemple « 2 documents ».

  • Heure : une version de modifications manuelles affiche l’intervalle entre sa première et sa dernière modification, marqué « En cours » tant qu’elle n’est pas close.
  • État : expliquée, en cours d’analyse ou pas encore expliquée, c’est-à-dire si le texte de cette version a ses explications ; survolez pour voir laquelle.
  • Source : distingue vos modifications de celles de l’Agent ; revenir à une version antérieure a sa propre icône.
L’historique des versions : les versions regroupées par jour à gauche, avec « Réorganisé : fusion de la règle de conservation des données » sélectionnée et les documents qu’elle a modifiés marqués dans l’arborescence ; à droite, Renouvellement marque les phrases que cette version a modifiées.

La partie haute de la barre latérale reste votre arborescence de documents, imbriquée et dépliée comme avant. Les documents que la version sélectionnée a modifiés sont marqués :

ModificationMarque
CrééUn point vert à côté du nom
ModifiéUn point jaune à côté du nom
SuppriméListé à son dernier emplacement, barré en rouge et atténué
RenomméLe nouveau nom, avec l’ancien en filigrane à côté

Ouvrir un document tel qu’il était

Sélectionnez une version et cliquez sur un document dans l’arborescence ; la zone principale l’ouvre tel qu’il était dans cette version. Un document d’historique est en lecture seule, avec un cadenas à côté de son titre qui, au survol, indique de quelle version il s’agit ; la mise en page, le plan, la recherche et les notes fonctionnent comme d’habitude, et vous pouvez sélectionner et copier le texte.

Le document marque ce que cette version a changé par rapport à la précédente, dans le style du mode relecture : ajouté, réécrit et supprimé, les paragraphes supprimés étant laissés en place. Vous pouvez les parcourir en bas.

Si cette version n’a pas modifié le document, vous voyez son contenu tel qu’il était à la dernière modification avant elle, avec l’heure dont il provient. Si le document n’existait pas encore dans cette version, ou si cette version l’a supprimé, cela est indiqué aussi.

Quand vous sélectionnez une autre version, un document d’historique ouvert suit, en montrant le même document tel qu’il était dans cette version. Une fenêtre n’a qu’un seul onglet d’historique à la fois.

Voir les explications de l’époque

Chaque paragraphe d’un document d’historique affiche l’explication du texte de cette version. Si le paragraphe a été réécrit ou supprimé depuis, sa note s’ouvre sur « Ceci explique le texte de cette version » : elle explique le texte tel qu’il était alors, et non le document tel qu’il est maintenant. Les paragraphes que cette version n’a pas expliqués sont marqués comme pas encore expliqués, et ceux en cours d’analyse comme « Examen en cours ».

Cela permet de répondre à « pourquoi l’avoir implémenté ainsi à l’époque ? ». Par exemple, quand la proposition de période de grâce a été acceptée il y a trois semaines, son explication listait le choix de compter 7 jours comme 168 heures ; ce n’est que plus tard qu’elle est passée aux jours calendaires dans le fuseau horaire de l’équipe.

Si vous voulez retrouver une version antérieure

L’historique des versions sert à regarder en arrière ; il n’a pas de « restaurer cette version ». Pour retrouver quelque chose, copiez le texte du document d’historique, collez-le dans le document actuel et enregistrez ; ou demandez à l’Agent dans une conversation de rédiger une proposition qui rétablit un paragraphe dans sa formulation antérieure, et acceptez-la après relecture.

Si vous gardez votre dossier d’intention dans Git, vous pouvez aussi restaurer les fichiers avec Git. Quand chaque document revient à un état enregistré, la liste des versions affiche une entrée intitulée « Retour à … ».