> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/features/contracts/versions.md).

# Versionner un document

Pour suivre les modifications, les mises à jour ou le renouvellement d'un document, créez-en une nouvelle version.

Chaque version porte un numéro de révision, incrémenté automatiquement à la création. Ce numéro est visible dans le registre. Un document n'a qu'une seule version active à la fois : c'est elle que le registre affiche, les versions inactives n'y figurent pas.

Vous pouvez parcourir les versions d'un document depuis le gestionnaire de versions, afficher une version précédente et rendre active n'importe quelle version à tout moment, y compris une version plus récente.

## Le gestionnaire de versions

Quand vous créez un document, Dastra crée sa version 1. Le bouton **Version** suivi du numéro, dans le menu d'actions principales, ouvre le gestionnaire de versions.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-d4260e6d0338ec923cf72e1ec942614b428dd75d%2Fcontracts-versions-1.png?alt=media" alt="Le bouton Version 1 dans le menu d&#x27;actions principales de la fiche"><figcaption><p>Le bouton d'accès au gestionnaire de versions</p></figcaption></figure>

Le gestionnaire liste toutes les versions du document. Chaque carte indique le numéro de version, sa description, sa date de création et le nombre de ses pièces jointes. Une pastille donne l'état de la version : verte pour la version **Actif**, rouge pour une version **Désactivé**. La mention **(En cours d'affichage)** désigne la version que vous consultez à l'écran.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-52cea43637fd465162489559080434211c36c8ab%2Fcontracts-versions-2.png?alt=media" alt="Le gestionnaire de versions avec plusieurs versions, dont la version active et la version affichée"><figcaption><p>Le gestionnaire de versions</p></figcaption></figure>

## Créer une nouvelle version

La nouvelle version part de la version actuellement affichée : placez-vous d'abord sur la version dont vous voulez partir.

1. Dans le gestionnaire de versions, cliquez sur **Créer une nouvelle version**.
2. Renseignez la **Date de début** et, si besoin, la **Date de fin**. Vous pourrez les modifier ensuite.
3. Ajoutez une **Description de la version** si vous le souhaitez.
4. Activez **Copier les pièces jointes dans la nouvelle version** pour reprendre les fichiers.
5. Cliquez sur **Créer une nouvelle version**.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-2a112162cff04f98a5827be09a9472b2be2ce30d%2Fcontracts-versions-3.png?alt=media" alt="La fenêtre de création d&#x27;une version avec les dates, la description et l&#x27;option de copie des pièces jointes"><figcaption><p>La fenêtre de création d'une version</p></figcaption></figure>

Le nom du document, sa description, son unité organisationnelle, ses actifs, ses signataires et ses utilisateurs sont conservés dans la nouvelle version. La version créée devient la version active, et celle qui s'affiche.

## Afficher une version

Dans le gestionnaire de versions, ouvrez le menu de la version (les trois points), puis cliquez sur **Afficher**. Cette action n'est pas proposée pour la version déjà affichée.

Vous pouvez afficher et modifier une version qui n'est pas la version active. Dastra le rappelle par un message dans le gestionnaire et par la mention **Version inactive** au-dessus des onglets de la fiche. Ne confondez pas la version active, unique et de référence, avec la version affichée.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-06806fffa886d458518c8d512bbecc24592c34c7%2Fcontracts-versions-4.png?alt=media" alt="La fiche d&#x27;un document affichant une version inactive, avec la mention Version inactive"><figcaption><p>La version 4 est la version active, mais vous pouvez afficher et modifier la version 2</p></figcaption></figure>

## Rendre une version active

Une version créée devient automatiquement la version active. Pour rendre une autre version active, ouvrez son menu dans le gestionnaire de versions et cliquez sur **Activer**. Cette action n'est proposée que pour les versions inactives.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-e99a4ea221cc68ab491c0048cc6dba340381c02d%2Fcontracts-versions-5.png?alt=media" alt="Le menu d&#x27;une version inactive avec l&#x27;action Activer"><figcaption><p>Définir une version comme version active</p></figcaption></figure>

## Modifier la description d'une version

Pour changer la description d'une version existante, ouvrez son menu et cliquez sur **Editer la description de la version**. Modifiez le texte dans la fenêtre qui s'ouvre, puis cliquez sur **Editer la version**.

## Supprimer une version

Ouvrez le menu d'une version inactive et cliquez sur **Supprimer**. Vous ne pouvez supprimer ni la version active, ni la version actuellement affichée : affichez une autre version pour supprimer celle-ci.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-82957fdf1175431a4a87b264073ea27d3a7f8eba%2Fcontracts-versions-6.png?alt=media" alt="Le menu d&#x27;une version inactive avec l&#x27;action Supprimer"><figcaption><p>Supprimer une version</p></figcaption></figure>

Supprimer un document supprime sa version active et toutes ses versions inactives.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.dastra.eu/features/contracts/versions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
