# Demandes de modification dans un espace

Lorsque vous êtes dans un [espace](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/getting-started/concepts#space)vous pouvez effectuer des modifications en ouvrant une nouvelle demande de modification, ou parcourir les demandes de modification existantes pour voir sur quoi d’autres personnes travaillent.

### Créer une demande de modification

Cliquez sur le **Modifier** bouton dans l’ [en-tête de l’espace](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/ressources/gitbook-ui#space-header) pour démarrer une nouvelle demande de modification.

Cela ouvrira une nouvelle demande de modification, où vous pourrez modifier ou supprimer du contenu selon vos besoins. Vos modifications sont enregistrées automatiquement, et d’autres personnes peuvent se joindre à votre demande de modification pour collaborer en temps réel.

Lorsque vous créez une demande de modification, vous pouvez ajouter un titre et une description pour fournir davantage de contexte sur les modifications que vous apportez.

Une fois que vous êtes satisfait de vos modifications, vous pouvez utiliser le bouton dans la barre d’en-tête pour [**Demander une relecture**](#request-a-review-on-a-change-request) de votre demande de modification, ou [**Fusionner**](#merging-a-change-request) la fusionner directement dans la branche principale.

#### Créer une demande de modification avec GitBook Agent

[Agent GitBook](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/agent-gitbook/what-is-gitbook-agent) est un coéquipier IA qui peut [planifier et mettre en œuvre des demandes de modification](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/agent-gitbook/write-and-edit-with-ai#implement-a-change-request-with-gitbook-agent) en fonction de toute consigne que vous lui donnez.

Pour ouvrir une nouvelle demande de modification avec GitBook Agent, cliquez sur l’icône GitBook Agent dans le coin supérieur droit, à côté du bouton « Modifier », et demandez à GitBook d’appliquer les modifications que vous souhaitez.

Voici quelques exemples de ce que vous pouvez lui demander de faire :

* Ajouter des exemples d’utilisation
* Améliorer le référencement de la page
* Améliorer la clarté
* Vérifier la cohérence
* Corriger les fautes de frappe et d’orthographe
* Lier le contenu associé
* \+ et plus encore

Accédez à [Écrire avec GitBook Agent](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/agent-gitbook/write-and-edit-with-ai) pour en savoir plus.

### Prévisualiser une demande de modification

Vous pouvez prévisualiser les modifications que vous avez apportées dans une demande de modification en cliquant sur l’ **Aperçu** option dans le [en-tête de l’espace](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/ressources/gitbook-ui#space-header). Cela affichera un aperçu de vos docs publiées avec les modifications proposées incluses, afin que vous puissiez voir vos modifications dans l’ensemble du contexte de votre documentation publiée.

Sous le **Aperçu** bouton se trouve une URL de prévisualisation de votre site. Cliquez dessus et l’aperçu de votre site s’ouvrira en plein dans un nouvel onglet.

Lorsque vous ouvrez une URL d’aperçu dans un nouvel onglet, vous verrez également [la barre d’outils d’aperçu](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/ressources/gitbook-ui/toolbar-on-published-sites-and-site-previews) en bas de la fenêtre du navigateur. Cette barre d’outils vous permet de revenir rapidement dans GitBook pour consulter, modifier ou commenter la demande de modification, ou d’ouvrir la version en ligne de votre site.

{% hint style="info" %}
Vous pouvez uniquement prévisualiser les demandes de modification pour les espaces ajoutés à un [site de documentation publié](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/publishing-documentation/publish-a-docs-site).
{% endhint %}

{% hint style="warning" %}
Si votre contenu est publié via des liens de partage ou un accès authentifié, la fonction d’aperçu n’apparaîtra pas.
{% endhint %}

### Demander une relecture d’une demande de modification

Demandez une relecture de votre demande de modification lorsque vous souhaitez demander aux membres de votre équipe de vérifier votre contenu avant de fusionner les modifications dans la branche principale.

Sélectionnez l’intégration **Aperçu** onglet dans la barre d’en-tête de l’espace pour ouvrir une vue d’ensemble de votre demande de modification — y compris toutes les modifications que vous avez apportées dans la vue diff.

Ici, vous pouvez ajouter une description à votre demande de modification pour donner du contexte à vos relecteurs, et mentionner des personnes spécifiques que vous souhaitez voir vérifier votre travail.

Lorsque vous cliquez sur **Demander une relecture**, le statut de la demande de modification passera à **En relecture**, et toute personne que vous avez mentionnée dans votre demande de relecture recevra une notification.

Si vos modifications ne nécessitent pas de relecture, que vous disposez des [autorisations](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/gestion-du-compte/member-management/roles)appropriés, et que vous n’avez aucune [règle de fusion](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/collaboration/merge-rules)bloquante, vous pouvez fusionner directement vos modifications dans la version principale à la place.

{% hint style="info" %}
[Ajouter GitBook Agent comme relecteur](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/agent-gitbook/review-change-requests-with-gitbook-agent) à votre demande de modification et il peut vérifier votre contenu pour détecter les fautes d’orthographe, de grammaire et les erreurs de guide de style, suggérer des améliorations et plus encore.
{% endhint %}

{% hint style="warning" %}
Si vous ne mentionnez personne dans votre demande de relecture, toute personne ayant des autorisations de relecteur recevra une notification à propos de votre demande. Si aucun relecteur n’est dans l’espace, le rôle suivant au-dessus de relecteur sera notifié.
{% endhint %}

#### Vue diff <a href="#diff-mode" id="diff-mode"></a>

Lorsque vous ouvrez l’ **Modifications** onglet dans l’en-tête de l’espace, la vue diff s’affichera. La vue diff met en évidence chaque page et bloc qui a été modifié dans une demande de modification. Elle met en évidence les pages modifiées dans la table des matières, et sur les pages elle affichera les blocs spécifiques qui ont été ajoutés, modifiés ou supprimés.

Il existe deux options lors de l’utilisation de la vue diff :

1. **Afficher toutes les pages** – Il s’agit du mode par défaut de la vue diff, qui affichera à la fois les pages modifiées et non modifiées dans la table des matières. C’est utile pour voir quelles pages ont été modifiées dans le contexte de l’ensemble de l’espace.
2. **Afficher uniquement les pages modifiées** – Ce mode n’affichera que les pages modifiées dans la table des matières, ce qui vous aide à vous concentrer sur le contenu modifié. C’est particulièrement utile dans les grands espaces avec de nombreuses pages et sous-pages.

Vous pouvez passer à l’ **Modifications** onglet pour vérifier la vue diff dans n’importe quelle demande de modification.

### Fusionner une demande de modification

Fusionner une demande de modification ajoutera les modifications de la demande de modification dans la branche principale du contenu, créant une version mise à jour et une nouvelle entrée dans l’ [historique des versions](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/creating-content/version-control#see-the-activity-of-a-specific-draft).

Il se peut que vous ne puissiez pas fusionner une demande de modification si vous n’avez pas les [autorisations](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/gestion-du-compte/member-management/permissions-and-inheritance)appropriées, ou si votre demande de modification n’a pas passé les [règle de fusion](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/collaboration/merge-rules).

### Mettre à jour une demande de modification

Pendant que vous travaillez dans une demande de modification, d’autres contributeurs peuvent modifier la branche principale de l’espace. Lorsque cela se produit, votre demande de modification est considérée comme « obsolète » — il y a du contenu sur la branche principale que vous ne voyez pas dans votre demande de modification.

Vous souhaiterez peut-être intégrer ce nouveau contenu dans votre demande de modification. Cela peut être utile si :

* Vous voulez voir à quoi ressemblent vos modifications et le contenu sur la branche principale une fois que tout est réuni.
* Vous devez apporter des modifications au contenu importé dans le cadre de votre demande de modification.

Vous pouvez le faire en appuyant sur **Mettre à jour** dans l’en-tête de l’écran de la demande de modification.

Une fois que vous appuyez sur **Mettre à jour**, tout le contenu de la branche principale est importé dans votre demande de modification. Vous pourriez rencontrer des conflits lors de la mise à jour — vous pourrez les résoudre dans la demande de modification. Une fois les conflits résolus, la demande de modification est considérée comme à jour et le bouton Mettre à jour disparaît.

Si la branche principale change à nouveau, votre demande de modification redeviendra obsolète et le bouton Mettre à jour réapparaîtra.

Demander aux éditeurs de garder leurs demandes de modification à jour avant la fusion est une bonne mesure de contrôle qualité — cela aide les auteurs à vérifier le contenu exact qui sera intégré à la branche principale une fois leur demande de modification fusionnée. Vous pouvez imposer cela avec une [règle de fusion](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/collaboration/merge-rules).

### Résoudre les conflits de fusion

Parfois, lorsque vous souhaitez fusionner une demande de modification, vous pouvez découvrir des conflits entre le contenu principal et le contenu que vous essayez de fusionner. Dans sa forme la plus simple, un conflit est un élément de contenu qui n’a pas pu être fusionné automatiquement.

Si cela se produit, vous verrez une alerte de conflit, ainsi qu’une liste des conflits que vous devrez résoudre avant de poursuivre la fusion.

Vous avez deux options lorsqu’il s’agit de résoudre un conflit de fusion — **sélectionner une version à fusionner** ou **manuellement** **modifier le contenu**.

#### Sélectionner une version à fusionner

Vous pouvez résoudre un conflit de fusion en sélectionnant une version que vous souhaitez fusionner — soit votre contenu entrant, soit le contenu qui s’y trouvait auparavant. Cela vous permet de choisir entre une modification et une autre — soit votre travail récent, soit le contenu d’origine.

Si vous traitez un conflit de fusion qui peut être résolu de cette manière, vous pouvez sélectionner la version que vous souhaitez conserver, et l’autre version sera supprimée.

#### Modification manuelle

Si vous ne voulez pas choisir entre les versions, vous pouvez résoudre un conflit de fusion en modifiant manuellement le conflit. Vous pourrez supprimer les blocs dont vous n’avez pas besoin, ou même les réécrire entièrement. Une fois que vous êtes satisfait des modifications, vous pouvez passer au conflit suivant jusqu’à ce qu’ils soient tous résolus.

### Archiver une demande de modification

Si vous décidez de ne pas fusionner une demande de modification et que vous souhaitez la retirer de la file d’attente, vous pouvez l’archiver.

Pour archiver une demande de modification, ouvrez-la d’abord. Puis cliquez sur le **menu d’actions** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FPnnI41SqLSaKBNwT98fW%2Factions-horizontal.svg?alt=media&#x26;token=99754200-a354-4ffe-931e-aa6322ea7395" alt="The Actions menu icon in GitBook"></picture> à côté du titre de la demande de modification et choisissez **Archiver**. Vous pourrez retrouver et rouvrir les demandes de modification archivées plus tard en ouvrant le **Demandes de modification** menu et en sélectionnant l’ **Archivées** onglet.
