Créez des brouillons isolés dans l’éditeur qui restent privés jusqu’à ce que vous demandiez une révision et les publiiez, sans avoir à gérer vous-même les branches Git.
Utilisez les brouillons pour travailler sur des modifications dans l’éditeur avant de les publier sur votre site en production. Un brouillon est un espace de travail isolé où vous rédigez, prévisualisez et modifiez du contenu. Vos modifications ne sont disponibles que dans l’éditeur jusqu’à ce que vous choisissiez de les publier.Les brouillons sont la méthode recommandée pour apporter des modifications dans l’éditeur. Chaque brouillon dispose d’une branche Git et d’une pull request que l’éditeur gère pour vous, ce qui vous permet de travailler sans changer de branche ni ouvrir de pull requests.
Chaque modification est enregistrée automatiquement. Au fur et à mesure que vous tapez, l’éditeur enregistre votre travail sur les serveurs de Mintlify, puis en arrière-plan commite les modifications sur la branche du brouillon. Vos modifications persistent d’un onglet, d’un appareil et d’une interruption réseau à l’autre.Chaque brouillon a son propre historique de versions. L’éditeur commite les modifications à mesure que vous travaillez, si bien qu’un brouillon accumule un historique de modifications sur sa branche. Il maintient également une pull request ouverte qui reflète l’état actuel du brouillon.Rien n’est mis en ligne tant que vous ne publiez pas. Un brouillon n’affecte jamais votre site en production pendant que vous le modifiez. C’est vous qui décidez quand ses modifications sont déployées.Conservez plusieurs brouillons en même temps. Travaillez en parallèle sur plusieurs jeux de modifications, chacun dans son propre brouillon, et publiez-les séparément.
Les brouillons sont distincts de la branche de déploiement qui construit votre site en production. Modifier un brouillon ne change jamais votre site en production tant que vous ne publiez pas le brouillon.
Cliquez sur le sélecteur de déploiement dans la barre d’outils de l’éditeur. Lorsque vous modifiez votre branche de déploiement, il affiche Live site. Lorsque vous modifiez un brouillon, il affiche le nom du brouillon.
Cliquez sur l’onglet Drafts.
Cliquez sur New draft.
L’éditeur crée le brouillon et bascule vers celui-ci. Les nouveaux brouillons portent au départ le nom “Untitled draft”. Renommez vos brouillons avec des noms descriptifs pour pouvoir les identifier plus tard.
Cliquez sur le sélecteur de déploiement dans la barre d’outils de l’éditeur.
Cliquez sur Live site pour revenir à votre branche de déploiement, ou cliquez sur un autre brouillon pour y basculer.
L’onglet Drafts liste vos brouillons avec l’heure de dernière mise à jour de chacun, du plus récent au plus ancien. Utilisez le champ de recherche pour filtrer les brouillons par nom.
Lorsque votre brouillon est prêt, ouvrez le menu de publication pour passer en revue vos modifications et publier. Les actions disponibles dépendent du fait que votre branche de déploiement exige ou non une révision avant la mise en ligne des modifications.
1
Ouvrez le menu de publication
Cliquez sur Publish dans la barre d’outils de l’éditeur. Le menu liste toutes les modifications en attente dans le brouillon. Cliquez sur n’importe quelle modification pour la passer en revue.
2
Demander une révision (si nécessaire)
Si votre branche de déploiement exige une révision, cliquez sur Request review pour marquer la pull request du brouillon comme prête à être révisée par votre équipe. Les relecteurs approuvent la pull request depuis l’éditeur ou depuis votre fournisseur Git.
3
Publier
Cliquez sur Publish pour fusionner le brouillon dans votre branche de déploiement et le déployer. Si votre équipe exige des révisions, Publish ne devient disponible qu’après approbation de la pull request.Une seule publication à la fois peut avoir lieu par brouillon. Si une publication est déjà en cours, attendez qu’elle se termine avant de republier.
Les brouillons et les branches vous permettent tous deux de travailler sur des modifications de manière isolée avant de les publier. Choisissez en fonction de la façon dont votre équipe travaille :
Utilisez les brouillons si vous voulez que l’éditeur gère Git à votre place.
Utilisez les branches si vous suivez un flux de travail basé sur Git et souhaitez nommer les branches, gérer directement les pull requests ou vous coordonner avec des modifications effectuées en dehors de l’éditeur. Voir Branching et publication.
Les deux options sont disponibles dans le sélecteur de déploiement, ce qui vous permet de passer d’une approche à l’autre à tout moment.
