> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/collaborer/change-requests/change-requests-in-a-space.md). # Demandes de modification dans une section Lorsque vous êtes dans une [section](/docs/documentation/fr/reference/concepts.md#space), vous pouvez apporter des modifications en ouvrant une nouvelle demande de modification, ou parcourir les demandes de modification existantes pour voir sur quoi les autres travaillent. ### Créer une demande de modification Cliquez sur le **Modifier** bouton dans le [l’en-tête de section](/docs/documentation/fr/reference/gitbook-ui.md#space-header) pour démarrer une nouvelle demande de modification. Cela ouvrira une nouvelle demande de modification, dans laquelle vous pourrez modifier ou supprimer du contenu selon vos besoins. Vos modifications sont enregistrées automatiquement, et d’autres personnes peuvent vous rejoindre dans une demande de modification pour collaborer en temps réel. Lors de la création d’une demande de modification, vous pouvez ajouter un titre et une description pour fournir davantage de contexte sur les modifications que vous apportez. Vous pouvez également lier la demande de modification à une source, notamment : * tickets Linear * pull requests ou issues GitHub * tickets Jira * URL générales Ces liens apparaissent sur la demande de modification, afin que les réviseurs puissent retracer l’origine du travail. Une fois 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](/docs/documentation/fr/agent-gitbook/overview.md) est un coéquipier IA qui peut [planifier et mettre en œuvre des demandes de modification](/docs/documentation/fr/agent-gitbook/write-and-edit-with-ai.md#implement-a-change-request-with-gitbook-agent) sur la base de toute instruction 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 », puis demandez à GitBook d’appliquer les modifications souhaitées. Voici quelques exemples de ce que vous pouvez lui demander de faire : * Ajouter des exemples d’utilisation * Améliorer le SEO de la page * Améliorer la clarté * Vérifier la cohérence * Corriger les fautes de frappe et d’orthographe * Lier le contenu connexe * \+ et plus encore Allez dans [Écrire avec GitBook Agent](/docs/documentation/fr/agent-gitbook/write-and-edit-with-ai.md) pour en savoir plus. ### Prévisualiser une demande de modification Vous pouvez prévisualiser les modifications apportées dans une demande de modification en cliquant sur **Aperçu** l’option dans le [l’en-tête de section](/docs/documentation/fr/reference/gitbook-ui.md#space-header). Cela basculera vers un aperçu de vos documents publiés avec les modifications proposées incluses, afin que vous puissiez voir vos modifications dans le contexte complet de votre documentation publiée. Sous le **Aperçu** bouton se trouve une URL pour l’aperçu de votre site. Cliquez dessus et l’aperçu de votre site s’ouvrira en entier 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](/docs/documentation/fr/gerer-votre-site/customization/toolbar-on-published-sites-and-site-previews.md) 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 ouvrir la version en ligne de votre site. {% hint style="info" %} Vous ne pouvez prévisualiser que les demandes de modification pour les sections ajoutées à un [site de documentation publiée](/docs/documentation/fr/publier/publish-a-docs-site.md). {% endhint %} {% hint style="warning" %} Si votre contenu est publié à l’aide de liens de partage ou d’un accès authentifié, la fonction d’aperçu n’apparaîtra pas. {% endhint %} ### Demander une revue sur une demande de modification Demandez une revue sur votre demande de modification lorsque vous voulez demander aux membres de votre équipe de vérifier votre contenu avant de fusionner les modifications dans la branche principale. Cliquez sur le **Vue d’ensemble** onglet dans la barre d’en-tête de la section pour ouvrir une vue d’ensemble de votre demande de modification — y compris toutes les modifications que vous avez apportées en vue diff. Utilisez la commande **Vue d’ensemble** onglet pour ajouter du contexte et des réviseurs. Pour inspecter les diffs dans l’éditeur, passez à l’ **Modifications** onglet. Dans cette vue, les pages avec des différences affichent un indicateur, et le contrôle flottant de navigation des différences vous aide à passer plus rapidement d’un bloc modifié à l’autre. Ici, vous pouvez ajouter une description à votre demande de modification pour donner du contexte à vos réviseurs, et mentionner des personnes spécifiques que vous souhaitez faire vérifier votre travail. Lorsque vous cliquez sur **Demander une relecture**, **En cours de révision**, et toute personne que vous avez mentionnée dans votre demande de revue recevra une notification. Si vos modifications ne nécessitent pas de revue, vous disposez des [autorisations](/docs/documentation/fr/collaborer/member-management/roles.md), et vous n’avez aucune [règle de fusion](/docs/documentation/fr/collaborer/merge-rules.md), vous pouvez fusionner directement vos modifications dans la version principale à la place. {% hint style="info" %} [Ajouter GitBook Agent comme réviseur](/docs/documentation/fr/agent-gitbook/review-change-requests-with-gitbook-agent.md) à 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 revue, toutes les personnes ayant les autorisations de réviseur dans la section recevront une notification. Si la section n’a aucun réviseur, le rôle suivant au-dessus de réviseur recevra la notification. {% endhint %} #### Vue diff Si une page contient des différences, GitBook affiche également un indicateur flottant centré. Cliquez dessus pour faire défiler jusqu’au premier bloc ou élément modifié. Lorsque vous ouvrez le **Modifications** onglet dans l’en-tête de la section, GitBook affiche chaque page et chaque bloc modifié dans la demande de modification. GitBook affiche la version précédente à gauche et la version mise à jour à droite. Il est ainsi plus facile de comparer les modifications côte à côte. Les pages qui contiennent des différences affichent également un indicateur dans la table des matières, ce qui facilite la consultation des grandes demandes de modification. Lorsque vous examinez une page dans l’ **Modifications** onglet de l’éditeur, un contrôle de navigation flottant des différences vous aide à passer plus rapidement d’un bloc modifié à l’autre, sans faire défiler toute la page. Deux options s’offrent à vous lors de l’utilisation de la vue des différences : 1. **Afficher toutes les pages** — Cela affiche dans la table des matières les pages modifiées et non modifiées, afin que vous puissiez examiner les modifications dans le contexte de la section entière. 2. **Afficher uniquement les pages modifiées** — Cela affiche uniquement les pages modifiées, afin que vous puissiez vous concentrer sur le contenu édité. Vous pouvez passer à l’ **Modifications** onglet pour vérifier la vue des différences dans n’importe quelle demande de modification.

Il s’agit du widget de contrôles de navigation en bas de l’écran Modifications

### Fusionner une demande de modification La fusion d’une demande de modification ajoutera les changements de la demande de modification à la branche principale du contenu, créant une version mise à jour et une nouvelle entrée dans la [historique des versions](/docs/documentation/fr/creer-du-contenu/version-control.md#see-the-activity-of-a-specific-draft). Il se peut que vous ne puissiez pas fusionner une demande de modification si vous ne disposez pas des bonnes [autorisations](/docs/documentation/fr/collaborer/member-management/permissions-and-inheritance.md), ou si votre demande de modification n’a pas passé les [règle de fusion](/docs/documentation/fr/collaborer/merge-rules.md). ### Mettre à jour une demande de modification Pendant que vous travaillez dans une demande de modification, d’autres contributeurs peuvent modifier la branche principale de la section. 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 pouvez vouloir 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 récupéré 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 avez appuyé sur **Mettre à jour**, tout le contenu de la branche principale est intégré à votre demande de modification. Vous pouvez 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 mettre leurs demandes de modification à jour avant la fusion est un bon contrôle qualité — cela aide les auteurs à vérifier le contenu exact qui ira dans la branche principale une fois leur demande de modification fusionnée. Vous pouvez imposer cela avec une [règle de fusion](/docs/documentation/fr/collaborer/merge-rules.md). ### 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, une alerte de conflit s’affichera, ainsi qu’une liste des conflits que vous devrez résoudre avant de poursuivre la fusion. Vous avez deux options pour 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 était précédemment là. Cela vous permet de choisir entre une modification et une autre — soit votre travail récent, soit le contenu d’origine. Si vous êtes confronté à un conflit de fusion pouvant ê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 souhaitez pas choisir entre les versions, vous pouvez résoudre un conflit de fusion en le modifiant manuellement. Vous pourrez supprimer les blocs dont vous n’avez pas besoin, ou même les réécrire entièrement. Une fois satisfait des modifications, vous pouvez passer au conflit suivant jusqu’à ce qu’ils soient tous résolus. ### Archiver une demande de modification Vous ne pouvez pas supprimer une demande de modification dans GitBook, mais vous pouvez l’archiver à la place. Pour archiver une demande de modification : 1. Ouvrez le **Demandes de modification** onglet. 2. Cliquez sur la demande de modification que vous souhaitez archiver. 3. Cliquez sur le **Actions** menu The Actions menu icon in GitBook à côté du titre de la demande de modification, puis choisissez **Archiver**. Pour retrouver et rouvrir une demande de modification archivée, ouvrez le **Demandes de modification** menu et cliquez sur le **Archivé** onglet. --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://gitbook.com/docs/documentation/fr/collaborer/change-requests/change-requests-in-a-space.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.