Passer au contenu principal
Git vous permet de contrôler et de suivre les modifications apportées aux fichiers. C’est le système de contrôle de version qui sous-tend les workflows basés sur des branches, où vous gérez votre contenu de la même manière que n’importe quelle autre base de code. L’éditeur web gère les opérations Git à votre place. Comprendre quelques concepts clés vous aide à tirer le meilleur parti de l’éditeur et à collaborer efficacement avec votre équipe.

​
Ce que Git fait pour votre contenu

Git suit chaque modification apportée à votre contenu. Il enregistre ce qui a changé, qui l’a modifié, quand et pourquoi. Cela vous permet de :
  • Voir l’historique complet de n’importe quelle page.
  • Annuler des modifications en revenant à une version précédente.
  • Travailler sur des mises à jour sans affecter votre site en production.
  • Examiner les modifications avant leur mise en ligne.
Votre référentiel est l’ensemble des fichiers et de leur historique qui composent votre site. L’éditeur se connecte à ce référentiel pour synchroniser et publier votre contenu.

​
Concepts clés

Voici les concepts Git que vous rencontrerez le plus souvent en utilisant l’éditeur web.
Une capture enregistrée de vos modifications à un moment précis. Chaque commit inclut un message décrivant ce qui a changé et crée un enregistrement permanent dans l’historique de votre projet.Lorsque vous publiez des modifications, l’éditeur web crée un commit dans votre référentiel Git.
Une ligne de travail distincte dans votre référentiel. Parfois appelée feature branch.Votre site en production est généré à partir d’une branche de déploiement, généralement appelée main. Les autres branches vous permettent de travailler sur des modifications de manière indépendante, sans affecter votre site en production. Rien sur une branche n’est mis en ligne avant que vous ne la fusionniez dans votre branche de déploiement via une pull request.Basculez entre les branches à l’aide de la liste déroulante des branches dans la barre d’outils de l’éditeur. Si vous avez des modifications non publiées, l’éditeur vous permet de les transférer vers la nouvelle branche ou de les laisser sur votre branche actuelle.
La branche qui génère votre site en production, généralement appelée main. Les modifications fusionnées dans cette branche sont automatiquement déployées sur votre site.
Une proposition de fusionner des modifications d’une branche dans une autre. Les pull requests permettent à votre équipe d’examiner et de discuter les changements avant leur mise en production.Lorsque vous publiez des modifications sur une feature branch (ou lorsque votre référentiel exige des pull requests), l’éditeur web crée une pull request. Votre équipe examine et fusionne la pull request dans votre fournisseur Git (GitHub ou GitLab).
Combinaison des modifications d’une branche dans une autre. Après qu’une pull request a été examinée et approuvée par votre équipe, la fusion de la branche intègre vos modifications dans la branche de déploiement et les publie.
Se produit lorsque deux branches comportent des modifications incompatibles sur les mêmes fichiers. L’éditeur vous aide à résoudre les conflits lorsqu’ils surviennent.
Une comparaison montrant les différences entre deux versions d’un fichier. L’éditeur affiche un diff visuel de vos modifications en attente avant la publication, afin que vous puissiez vérifier exactement ce qui sera validé.

​
Correspondance entre l’éditeur et Git

Chaque action dans l’éditeur web correspond à une opération Git. Voici la référence complète :
Action dans l’éditeurOpération Git
Modifier une pageLes modifications sont enregistrées automatiquement sur les serveurs Mintlify. Pas encore de commit Git.
Publier sur votre branche de déploiementgit commit et git push. Déclenche un déploiement.
Save in branchgit commit sur la branche de fonctionnalité actuelle.
Create pull requestgit push et ouvre une pull request vers votre branche de déploiement.
Merge and publishFusionne la pull request et déclenche un déploiement.
Créer une branchegit checkout -b <branch-name>
Changer de branchegit checkout <branch-name>
Push externe ou mise à jour via la CLILes modifications entrantes sont synchronisées automatiquement dans l’éditeur via un three-way merge.

Sujets connexes

Branches et publicationConcepts de Git pour la documentationIntégrations de l'agent