L'IA peut-elle réécrire la documentation pour moi ?

Non. L'IA identifie les problèmes de structure et signale ce qui doit changer, mais c'est à vous d'effectuer la rédaction et le déplacement du contenu.

Va-t-elle modifier mes fichiers existants ?

Non. L'IA se contente de lire et d'analyser vos fichiers pour fournir un retour. Elle n'a pas la permission d'écrire ou d'écraser vos documents.

Fonctionne-t-elle avec n'importe quel format de documentation ?

Elle fonctionne avec les formats textuels standards comme le Markdown, tant que votre client IA peut les lire.

Peut-elle corriger mon ton ?

Non. Cet outil sert spécifiquement à appliquer le cadre structurel Diátaxis, pas à effectuer de l'édition stylistique ou tonale.

Comment sait-elle si une section est un tutoriel ?

Elle utilise l'outil validate_technical_writing pour comparer l'intention du contenu aux caractéristiques précises des quadrants Diátaxis.

TUTORIALHOW-TOREFERENCEHUMAN

TUTORIAL
HOW-TO
REFERENCE
HUMAN

Appliquer la structure Diátaxis avec votre IA

Connectez ce MCP à votre agent pour qu'il ne confonde plus tutoriels et références. Il force votre documentation à respecter les quatre quadrants de Diátaxis.

Demandez à l'IA à propos de cette page

Réponse rapide

Comment faire respecter Diátaxis à mon IA ?

Votre agent utilise l'outil validate_technical_writing pour vérifier si votre contenu correspond aux quatre catégories Diátaxis : tutoriels, guides pratiques, références et explications. Il signale les contenus qui mélangent ces types afin que vous puissiez corriger la structure. Vous obtiendrez une répartition claire des éléments à déplacer.

Chaque problème est classé.

Les résultats structurels

L'IA catégorise votre contenu selon son intention et son objectif.

TUTORIAL

Parcours d'apprentissage

L'IA identifie le contenu destiné à l'apprentissage par la pratique. Elle veille à ce que ces sections permettent à un débutant d'atteindre un résultat concret.

HOW-TO

Guides pratiques

L'agent signale le contenu qui devrait être un guide étape par étape. Il vérifie que ces sections résolvent des problèmes utilisateurs spécifiques.

REFERENCE

Faits et informations

L'IA extrait les spécifications techniques et les descriptions. Elle s'assure qu'elles restent factuelles et neutres, sans fioritures pédagogiques.

HUMAN

Corrections manuelles

L'IA signale le contenu qui viole les règles de Diátaxis. Vous recevrez ces alertes précises pour effectuer la réorganisation finale.

Le flux

Ce que fait votre IA dès réception de la documentation.

L'agent agit comme un auditeur structurel pour vos documents techniques.

Analyser l'intention
L'agent lit votre texte brut pour déterminer s'il enseigne, guide ou décrit.
validate_technical_writing
Vérifier la conformité Diátaxis
Il compare votre contenu aux quatre quadrants pour détecter les mélanges de types.
validate_technical_writing
Identifier les erreurs de structure
L'agent repère lorsqu'un tutoriel tente de servir de référence ou inversement.
validate_technical_writing
Générer la liste de corrections
Il produit une liste de blocs de contenu spécifiques à déplacer ou à réécrire.
validate_technical_writing

Essayez

Copiez ces exemples pour commencer.

Utilisez ces prompts pour lancer l'audit structurel.

Points de départ

Remplacez les noms de fichiers ou les chemins de dépôt par vos propres fichiers de documentation.

Technical Writing Prover Connector

Tout est prêt. Choisissez votre client MCP et suivez les instructions de configuration.

Lien du connecteurhttps://edge.vinkius.com/vk_preview_OWaZOabijYQqiXzNKgOGtWneCoMKT68VO6tDqnNd/mcp

Claude Desktop

Suivez les étapes ci-dessous pour vous connecter en quelques secondes.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — Technical Writing Prover capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopier

{
  "mcpServers": {
    "technical-writing-prover-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_OWaZOabijYQqiXzNKgOGtWneCoMKT68VO6tDqnNd/mcp"
    }
  }
}

Copiez dans le chat04

Vérifie la conformité Diátaxis de ce fichier markdown dans mon dépôt.
Ce tutoriel dans mon dossier docs contient-il trop de contenu de type référence ?
Audite la documentation de ce dépôt GitHub et signale les sections qui mélangent les intentions.
Examine ce guide technique et dis-moi s'il respecte les règles du quadrant how-to.

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Commencez ici

Connectez Technical Writing Prover une fois, puis posez vos questions.

Liez simplement le MCP à votre client. Vos identifiants restent chiffrés et vous pouvez auditer vos documents immédiatement.

Connecter Technical Writing Prover à votre IA

FAQ

Fonctionnement de la tâche

01
L'IA peut-elle réécrire la documentation pour moi ?
Non. L'IA identifie les problèmes de structure et signale ce qui doit changer, mais c'est à vous d'effectuer la rédaction et le déplacement du contenu.
02
Va-t-elle modifier mes fichiers existants ?
Non. L'IA se contente de lire et d'analyser vos fichiers pour fournir un retour. Elle n'a pas la permission d'écrire ou d'écraser vos documents.
03
Fonctionne-t-elle avec n'importe quel format de documentation ?
Elle fonctionne avec les formats textuels standards comme le Markdown, tant que votre client IA peut les lire.
04
Peut-elle corriger mon ton ?
Non. Cet outil sert spécifiquement à appliquer le cadre structurel Diátaxis, pas à effectuer de l'édition stylistique ou tonale.
05
Comment sait-elle si une section est un tutoriel ?
Elle utilise l'outil validate_technical_writing pour comparer l'intention du contenu aux caractéristiques précises des quadrants Diátaxis.
D'autres questions sur Technical Writing Prover ? La page du connecteur y répond. Voir toutes les capacités du connecteur Technical Writing Prover

Connectez Technical Writing Prover à Claude, Cursor, ChatGPT et d'autres