Rédiger de la documentation avec Devin Desktop

Transformez Devin Desktop en expert de la documentation qui comprend votre guide de style, vos composants et le contexte de votre projet grâce aux workspace rules et aux memories.

Cognition a racheté Windsurf et l’a renommé Devin Desktop. L’assistant IA Cascade et le système de workspace rules restent identiques.

Utilisez Devin Desktop avec Mintlify

Vous pouvez paramétrer l’assistant IA Cascade de Devin Desktop pour rédiger une documentation conforme à vos standards en utilisant les composants Mintlify. Les règles d’espace de travail et les mémoires fournissent un context persistant sur votre projet, garantissant des suggestions de Cascade plus cohérentes.

Règles d’espace de travail : elles se trouvent dans votre référentiel de documentation, donc toute votre équipe les partage.
Mémoires : fournissent un context individuel qui s’accumule au fil du temps.

Configurez des règles d’espace de travail pour définir des standards de documentation partagés. Vous pouvez enrichir vos mémoires au fil de votre travail, mais comme elles ne sont pas partagées, elles ne seront pas cohérentes entre les membres de l’équipe. Créez des règles d’espace de travail dans le répertoire .devin/rules de votre référentiel de documentation. Devin Desktop continue de prendre en charge les règles dans .windsurf/rules pour la rétrocompatibilité. Consultez Memories & Rules dans la documentation Devin Desktop pour plus d’informations.

Exemple de règle d’espace de travail

Cette règle fournit à Cascade du contexte sur les composants Mintlify et les meilleures pratiques générales de rédaction technique. Vous pouvez utiliser cette règle d’exemple telle quelle ou la personnaliser pour votre documentation :

Normes de rédaction : mettez à jour les consignes linguistiques pour les aligner sur votre guide de style.
Modèles de composants : ajoutez des composants spécifiques à votre projet ou modifiez des exemples existants.
Exemples de code : remplacez les exemples génériques par de vrais appels et réponses d’API propres à votre produit.
Préférences de style et de ton : ajustez la terminologie, la mise en forme et les autres règles.

Enregistrez votre règle en tant que fichier .md dans le répertoire .devin/rules de votre dépôt de documentation.

# Règle de rédaction technique Mintlify

## Contexte du projet

- Il s'agit d'un projet de documentation sur la plateforme Mintlify
- Nous utilisons des fichiers MDX avec du frontmatter YAML  
- La navigation est configurée dans `docs.json`
- Nous suivons les meilleures pratiques de rédaction technique

## Standards de rédaction

- Utilisez la deuxième personne (« vous ») pour les instructions
- Rédigez à la voix active et au présent
- Commencez les procédures par les prérequis
- Incluez les résultats attendus pour les étapes importantes
- Utilisez des titres descriptifs et riches en mots-clés
- Gardez les phrases concises mais informatives

## Structure de page requise

Chaque page doit commencer par du frontmatter :

```yaml
---
title: "Titre clair et spécifique"
description: "Description concise pour le SEO et la navigation"
---
```

## Composants Mintlify

### docs.json

- Référez-vous au [schéma docs.json](https://mintlify.com/docs.json) lors de la construction du fichier docs.json et de la navigation du site

### Encadrés

- `<Note>` pour des informations supplémentaires utiles
- `<Warning>` pour des avertissements importants et des changements majeurs
- `<Tip>` pour les meilleures pratiques et conseils d'expert  
- `<Info>` pour des informations contextuelles neutres
- `<Check>` pour les confirmations de succès

### Exemples de code

- Le cas échéant, incluez des exemples complets et exécutables
- Utilisez `<CodeGroup>` pour des exemples en plusieurs langages
- Spécifiez les balises de langage sur tous les blocs de code
- Incluez des données réalistes, pas des espaces réservés
- Utilisez `<RequestExample>` et `<ResponseExample>` pour la documentation API

### Procédures

- Utilisez le composant `<Steps>` pour les instructions séquentielles
- Incluez des étapes de vérification avec les composants `<Check>` quand c'est pertinent
- Divisez les procédures complexes en étapes plus petites

### Organisation du contenu

- Utilisez `<Tabs>` pour le contenu spécifique à une plateforme
- Utilisez `<Accordion>` pour la divulgation progressive
- Utilisez `<Card>` et `<CardGroup>` pour mettre en évidence le contenu
- Enveloppez les images dans des composants `<Frame>` avec un texte alternatif descriptif

## Exigences de documentation API

- Documentez tous les paramètres avec `<ParamField>` 
- Montrez la structure de réponse avec `<ResponseField>`
- Incluez des exemples de succès et d'erreur
- Utilisez `<Expandable>` pour les propriétés d'objets imbriqués
- Incluez toujours des exemples d'authentification

## Standards de qualité

- Testez tous les exemples de code avant publication
- Utilisez des chemins relatifs pour les liens internes
- Incluez un texte alternatif pour toutes les images
- Assurez-vous d'une hiérarchie de titres appropriée (commencez par h2)
- Vérifiez les modèles existants pour la cohérence

Utilisation de Cascade

Une fois vos règles configurées, vous pouvez utiliser Cascade pour vous aider dans diverses tâches de documentation. Consultez Cascade dans la documentation de Devin Desktop pour en savoir plus.

Exemples d’instructions

Rédaction de nouveau contenu :

Créez une nouvelle page expliquant comment s'authentifier avec notre API. Incluez des exemples de code en JavaScript, Python et cURL.

Amélioration du contenu existant :

Examinez cette page et proposez des améliorations pour la clarté et l'utilisation des composants. Concentrez-vous sur la facilitation du suivi des étapes.

Créer des exemples de code :

Générez un exemple de code complet montrant la gestion des erreurs pour ce point de terminaison d'API. Utilisez des données réalistes et incluez les réponses attendues.

Assurer la cohérence :

Vérifiez si cette nouvelle page respecte nos normes de documentation et suggérez les modifications nécessaires.

Améliorez avec le serveur MCP

Connectez le serveur MCP de Mintlify à Devin Desktop pour permettre à Cascade de rechercher dans la documentation Mintlify tout en vous aidant à rédiger. Lorsque vous connectez le serveur MCP, Cascade interroge la documentation Mintlify à jour pour obtenir du contexte, afin que vous n’ayez pas à quitter votre IDE pour la consulter. Ajoutez le serveur MCP à ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "mintlify": {
      "serverUrl": "https://mintlify.com/docs/mcp"
    }
  }
}

Consultez Model Context Protocol dans la documentation Devin Desktop et Model Context Protocol dans la documentation Mintlify pour plus de détails.

​Utilisez Devin Desktop avec Mintlify

​Exemple de règle d’espace de travail

​Utilisation de Cascade

​Exemples d’instructions

​Améliorez avec le serveur MCP

Utilisez Devin Desktop avec Mintlify

Exemple de règle d’espace de travail

Utilisation de Cascade

Exemples d’instructions

Améliorez avec le serveur MCP