Passer au contenu principal
Connectez votre espace de travail Linear à l’agent pour effectuer des mises à jour de documentation depuis Linear. Lorsque vous mentionnez l’agent Mintlify dans un commentaire Linear ou que vous lui assignez une issue, l’agent récupère le contexte de l’issue et ouvre une pull request (demande de fusion) avec les modifications proposées pour votre documentation.

Connectez votre espace de travail Linear

  1. Accédez à la page Agent de votre Dashboard.
  2. Dans la section “Agent settings”, cliquez sur Install Linear app.
La section des paramètres d'application avec les boutons d'installation de Slack et Linear.
  1. Suivez les instructions de Linear pour autoriser l’application Mintlify dans votre espace de travail.

Utiliser l’agent dans Linear

Une fois connecté, mentionnez @mintlify dans une issue Linear ou assignez une issue à Mintlify pour déclencher une mise à jour de la documentation. L’agent utilise le titre, la description et le fil de commentaires de l’issue comme contexte, puis ouvre une pull request (demande de fusion) dans votre référentiel de documentation. Utilisez l’agent dans Linear pour :
  • Mettre à jour la documentation à partir d’issues de fonctionnalités : Lorsqu’une fonctionnalité est livrée, mentionnez l’agent dans l’issue pour rédiger ou mettre à jour la documentation correspondante.
  • Agir sur les retours de documentation : Créez des issues Linear pour les améliorations de documentation et mentionnez l’agent pour effectuer les modifications.
  • Générer des notes de version : Mentionnez l’agent dans une issue liée à une release pour rédiger des entrées de changelog basées sur les détails de l’issue.
  • Corriger les problèmes signalés : Lorsque quelqu’un signale un problème de documentation dans Linear, mentionnez l’agent pour le résoudre.

Bonnes pratiques

  • Incluez du contexte dans l’issue : Plus vous fournissez de contexte dans une issue, meilleure sera la pull request (demande de fusion) résultante.
  • Relisez les pull requests : Relisez toujours les pull requests (demandes de fusion) créées par l’agent avant de les fusionner.
  • Itérez dans les commentaires : Répondez dans le même fil de l’issue pour affiner le résultat de l’agent, comme vous le feriez dans Slack.