Demandes de changement dans un espace
Apprenez à collaborer sur une seule demande de changement dans un espace — y compris comment examiner, résoudre les conflits et fusionner
Lorsque vous êtes dans un espace, vous pouvez apporter des modifications en ouvrant une nouvelle demande de changement, ou parcourir les demandes de changement existantes pour voir sur quoi les autres personnes travaillent.
Créer une demande de changement
Dans un espace où les modifications en direct sont désactivées, cliquez sur le Modifier bouton dans le en-tête de l’espace pour démarrer une nouvelle demande de changement.
Cela ouvrira une nouvelle demande de changement, où vous pourrez modifier ou supprimer du contenu selon les besoins. Vos modifications sont enregistrées automatiquement, et d'autres personnes peuvent vous rejoindre dans une demande de changement pour collaborer en temps réel.
Lorsque vous créez une demande de changement, vous pouvez ajouter un titre et une description pour fournir plus 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 de votre demande de changement, ou Fusionner la fusionner directement dans la branche principale.
Créer une demande de changement avec GitBook Agent
Agent GitBook est un coéquipier IA qui peut planifier et mettre en œuvre des demandes de changement en fonction de toutes les instructions que vous lui donnez.
Pour ouvrir une nouvelle demande de changement avec GitBook Agent, cliquez sur l'icône GitBook Agent en haut à droite à côté du bouton « Modifier », et demandez à GitBook d'implémenter les modifications que vous souhaitez.
Voici quelques actions 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 connexe
+ plus
Accédez à Rédiger avec GitBook Agent pour en savoir plus.
Aperçu d'une demande de changement
Vous pouvez prévisualiser les modifications que vous avez apportées dans une demande de changement en cliquant sur l'option Aperçu dans le en-tête de l’espace. Cela basculera vers un aperçu de vos docs publiés avec les modifications proposées incluses, afin que vous puissiez voir vos changements dans l'ensemble du contexte 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 en bas de la fenêtre du navigateur. Cette barre d'outils vous permet de revenir rapidement dans GitBook pour afficher, modifier ou commenter la demande de changement, ou ouvrir la version en direct de votre site.
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.
Demander une revue d'une demande de changement
Demandez une revue de votre demande de changement lorsque vous souhaitez que des membres de votre équipe vérifient votre contenu avant que vous fusionniez les modifications dans la branche principale.
Sélectionnez l' Aperçu onglet dans la barre d'en-tête de l'espace pour ouvrir un aperçu de votre demande de changement — y compris toutes les modifications que vous avez apportées en vue diff.
Ici, vous pouvez ajouter une description à votre demande de changement pour donner du contexte à vos relecteurs, et taguer 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 changement passera à En revue, et toute personne que vous avez taguée dans votre demande de revue recevra une notification.
Si vos modifications ne nécessitent pas de revue, que vous disposez des autorisationsappropriés, et que vous n'avez aucun règles de fusion, vous pouvez plutôt fusionner vos modifications directement dans la version principale.
Si vous ne taguez personne dans votre demande de revue, tous ceux qui ont des permissions de relecteur recevront une notification concernant votre demande. Si aucun relecteur n'est présent dans l'espace, le rôle supérieur suivant sera notifié.
Vue diff
Lorsque vous ouvrez l'onglet Modifications dans l'en-tête de l'espace, la vue diff apparaîtra. La vue diff met en évidence chaque page et bloc qui a été modifié dans une demande de changement. Elle mettra en évidence toutes les pages modifiées dans la table des matières, et sur les pages elle montrera les blocs spécifiques qui ont été ajoutés, modifiés ou supprimés.
Il y a deux options lors de l'utilisation de la vue diff :
Afficher toutes les pages – C'est le mode par défaut pour 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.
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 changé. C'est particulièrement utile dans les grands espaces avec de nombreuses pages et sous-pages.
Vous pouvez basculer vers l'onglet Modifications pour vérifier la vue diff dans n'importe quelle demande de changement.
Fusionner une demande de changement
Fusionner une demande de changement ajoutera les modifications de la demande de changement dans la branche principale du contenu, créant une version mise à jour et une nouvelle entrée dans l'historique des versions.
Vous ne pourrez peut-être pas fusionner une demande de changement si vous n'avez pas les autorisationsappropriés, ou si votre demande de changement n'a pas passé les règles de fusion.
Résolution des conflits de fusion
Parfois, lorsque vous souhaitez fusionner une demande de changement, 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 morceau de contenu qui n'a pas pu être fusionné automatiquement.
Si cela se produit, vous recevrez une alerte de conflit et 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 la version que vous souhaitez fusionner — soit votre contenu entrant, soit le contenu qui était précédemment en place. Cela vous permet de choisir entre une modification et une autre — soit votre travail récent, soit le contenu original.
Si vous avez affaire à 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 souhaitez 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 changement
Si vous décidez de ne pas fusionner une demande de changement et que vous souhaitez la retirer de la file d'attente, vous pouvez l'archiver.
Pour archiver une demande de changement, ouvrez-la d'abord. Cliquez ensuite sur le menu Actions 
à côté du titre de la demande de changement et choisissez Archiver. Vous pouvez retrouver et rouvrir les demandes de changement archivées plus tard en ouvrant le Demandes de changement menu et en sélectionnant le Archivé .
Mis à jour
Ce contenu vous a-t-il été utile ?