mintlify__docs/fr/editor/settings.mdx

---
title: "Paramètres de l'éditeur pour l'IA et la publication"
description: "Configurez les instructions d'IA, les consignes pour les commits et les pull requests, les pull requests en brouillon et la méthode de fusion par défaut de l'éditeur web Mintlify."
keywords: ["éditeur", "paramètres", "ai", "instructions", "publication", "pull request", "commit", "brouillon", "fusion"]
---

L'éditeur web comporte deux niveaux de paramètres :

- **Vos paramètres** ne s'appliquent qu'à vous et contrôlent la façon dont l'IA de l'éditeur vous assiste pendant vos modifications.
- **Les paramètres de publication** s'appliquent à toutes les personnes d'un déploiement et déterminent ce qui se passe lorsque les modifications sont committées puis transformées en pull requests.

Vous pouvez configurer les deux depuis le menu **Settings** de l'éditeur.

<div id="ai-instructions">
  ## Instructions d'IA
</div>

Les instructions d'IA sont des consignes persistantes que l'éditeur envoie à l'IA avec votre requête. Utilisez-les pour fixer des règles de style et de ton que vous ne voulez pas répéter à chaque fois, comme la voix, la terminologie ou les conventions de mise en forme.

Vos instructions s'appliquent à :

- Les actions **Edit with AI** sur une sélection, comme réécrire, développer ou corriger.
- Les **sessions de l'agent** lancées depuis l'éditeur.

Les instructions sont liées à votre compte utilisateur, donc chaque membre de l'équipe gère les siennes.

<div id="when-to-use-ai-instructions">
  ### Quand utiliser les instructions d'IA
</div>

Ajoutez des instructions d'IA lorsque vous vous surprenez à répéter les mêmes consignes dans vos prompts, par exemple :

- Imposer la deuxième personne ou des titres en majuscule initiale uniquement.
- Privilégier des noms de produit ou une terminologie spécifiques.
- Bannir le langage marketing ou les phrases de remplissage.
- Exiger certains composants, comme toujours utiliser `<Note>` pour les encarts.

Gardez les instructions courtes et précises. L'IA les suit à chaque requête, donc des règles vagues ou contradictoires dégradent les résultats.

<div id="configure-ai-instructions">
  ### Configurer les instructions d'IA
</div>

1. Ouvrez l'éditeur et cliquez sur votre avatar dans la barre d'outils.
2. Sélectionnez **Settings**.
3. Dans le champ **AI instructions**, saisissez les consignes que l'IA doit suivre.
4. Enregistrez vos modifications.

Exemple :

```text
- Use second person ("you") and active voice.
- Use sentence case for all headings.
- Refer to the product as "Acme" — never "Acme Inc." or "the platform".
- Wrap notes and warnings in <Note> or <Warning> components.
- Do not add introductory filler like "In this guide" or "Let's explore".
```

Laissez le champ vide pour supprimer vos instructions.

<div id="publishing-settings">
  ## Paramètres de publication
</div>

Les paramètres de publication se configurent par déploiement et s'appliquent à toutes les personnes qui publient depuis l'éditeur. Ils contrôlent la façon dont les pull requests et les commits sont générés, ouverts et fusionnés.

Vous devez disposer d'un accès administrateur à votre déploiement Mintlify pour modifier les paramètres de publication.

<div id="commit-message-instructions">
  ### Instructions pour le message de commit
</div>

Les instructions pour le message de commit guident l'IA lorsqu'elle génère un message de commit pour une publication. L'éditeur les utilise dès que vous publiez sans saisir votre propre message.

Utilisez les instructions pour le message de commit afin de respecter une convention existante dans votre dépôt, par exemple :

- Conventional Commits (`docs(editor): ...`).
- Un préfixe de ticket ou d'issue obligatoire.
- Une longueur maximale d'objet plus stricte que les 72 caractères par défaut.

Exemple :

```text
Follow Conventional Commits. Use the "docs" type and an "editor" scope
for content changes (for example, "docs(editor): clarify quickstart steps").
Keep the subject under 60 characters.
```

Si votre dépôt impose une expression régulière sur le message de commit, l'éditeur la valide quand même après la génération.

<div id="pull-request-instructions">
  ### Instructions pour la pull request
</div>

Les instructions pour la pull request guident l'IA lorsqu'elle génère le titre et la description d'une pull request. Elles s'appliquent dès que l'éditeur ouvre une pull request en votre nom, y compris dans les flux **Create pull request** et **Merge and publish**.

Utilisez les instructions pour la pull request afin de standardiser ce que voient les relecteurs, par exemple :

- Des sections obligatoires comme **Summary** et **Changes**.
- Un modèle de description qui renvoie vers un système de suivi.
- Des exigences de ton ou de longueur pour les titres.

Exemple :

```text
Title: imperative mood, under 70 characters, no trailing period.
Description: include a "## Summary" section (one sentence) and a
"## Changes" section as a bulleted list. Link any referenced page
using its relative path.
```

<div id="create-pull-requests-as-drafts-by-default">
  ### Créer les pull requests en brouillon par défaut
</div>

Activez cette option pour que l'éditeur ouvre chaque nouvelle pull request à l'état de brouillon. Vous ne pouvez pas fusionner une pull request en brouillon avant de la marquer comme prête pour la relecture. C'est utile quand :

- Votre équipe exige une relecture manuelle avant d'ouvrir la pull request pour approbation.
- Vous voulez partager les URLs de prévisualisation sans signaler que la modification est prête à être fusionnée.

Vous pouvez toujours marquer une pull request comme prête pour la relecture depuis votre fournisseur Git.

<div id="default-merge-method">
  ### Méthode de fusion par défaut
</div>

Choisissez la manière dont l'éditeur fusionne les pull requests lorsque vous cliquez sur **Merge and publish** :

- **Merge** : Crée un commit de fusion qui conserve l'historique complet de la branche.
- **Squash** : Combine tous les commits de la branche en un seul commit sur votre branche de déploiement.
- **Rebase** : Rejoue chaque commit de la branche sur votre branche de déploiement, sans commit de fusion.

La méthode sélectionnée est utilisée par défaut. Si vous passez une méthode de fusion explicite via l'API ou l'interface de votre fournisseur Git, ce choix prévaut.

<Tip>
  Alignez votre méthode de fusion par défaut sur les règles de protection de branche de votre fournisseur Git. Si votre branche de déploiement n'autorise que les fusions squash, définissez la valeur par défaut sur **Squash** pour éviter les échecs de fusion depuis l'éditeur.
</Tip>

<div id="related">
  ## Voir aussi
</div>

- [Publication](/fr/editor/publish)
- [Configurations](/fr/editor/configurations)