Notions essentielles de Git pour l'éditeur
Comprenez les concepts de contrôle de version Git derrière l'éditeur Mintlify : branches, commits, pull requests et workflows de fusion.
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.
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.
Voici les concepts Git que vous rencontrerez le plus souvent en utilisant l’éditeur web.
Chaque action dans l’éditeur web correspond à une opération Git. Voici la référence complète :
| Action dans l’éditeur | Opération Git |
|---|---|
| Modifier une page | Les modifications sont enregistrées automatiquement sur les serveurs Mintlify. Pas encore de commit Git. |
| Publier sur votre branche de déploiement | git commit et git push. Déclenche un déploiement. |
| Save in branch | git commit sur la branche de fonctionnalité actuelle. |
| Create pull request | git push et ouvre une pull request vers votre branche de déploiement. |
| Merge and publish | Fusionne la pull request et déclenche un déploiement. |
| Créer une branche | git checkout -b <branch-name> |
| Changer de branche | git checkout <branch-name> |
| Push externe ou mise à jour via la CLI | Les modifications entrantes sont synchronisées automatiquement dans l’éditeur via un three-way merge. |