Restructurer une documentation technique avec le cadre Diátaxis

Ce prompt diagnostique une documentation technique et la réorganise selon le cadre Diátaxis, qui distingue quatre formes : tutoriels, guides pratiques, référence et explication. Il repère les pages qui mélangent plusieurs besoins, propose une nouvelle arborescence et réécrit la page de votre choix. Aucun fait technique n'est modifié : ce qui paraît faux est signalé à l'équipe.

Développement

Technologie

Intermédiaire

Tous modèles

#documentation technique

#Diátaxis

#rédaction technique

#developer experience

#README

Mis à jour le 07/10/2026

Créé par Sébastien GrillotLinkedIn

Recommandations pour de meilleurs résultats

Activez le mode raisonnement

Ce prompt donne de meilleurs résultats quand l'IA réfléchit avant de répondre. Dans ChatGPT, sélectionnez Réfléchir, ou le niveau Moyen ou Élevé du curseur Réflexion avec une offre payante. Dans Claude, montez le niveau d'effort depuis le menu du modèle, à côté du bouton d'envoi. Dans Gemini, choisissez le raisonnement étendu quand il est proposé.

Notes d'utilisation

À utiliser quand la documentation existe mais que personne n'y trouve rien, ou avant une refonte de site de documentation. Diátaxis, créé par Daniele Procida, définit le tutoriel comme une leçon, le guide pratique comme une aide au travail d'un utilisateur déjà compétent, la référence comme la description technique exacte et l'explication comme ce qui donne le contexte et répond à la question du pourquoi. Le prompt ne connaît pas votre produit : relisez la page réécrite contre le comportement réel. Retirez des pages collées toute adresse interne, tout jeton et tout identifiant avant de les soumettre.

Contenu du prompt

Cliquez sur les zones [en surbrillance] pour les personnaliser

# Restructurer une documentation technique avec Diátaxis Tu es rédacteur technique. Tu aides l'équipe de à organiser sa documentation selon le cadre Diátaxis, qui distingue quatre formes répondant à quatre besoins : - le tutoriel, une leçon qui fait pratiquer un débutant pas à pas ; - le guide pratique, qui aide un utilisateur déjà compétent à accomplir une tâche précise ; - la référence, qui décrit les faits techniques de façon exacte, complète et neutre ; - l'explication, qui donne le contexte et répond à la question du pourquoi. ## Ce que je te fournis - Le public principal : - La page à réécrire en priorité : - La table des matières ou les pages existantes, collées après la ligne « DOCUMENTATION ». ## Règles - Tu ne modifies aucun fait technique : commandes, paramètres, valeurs par défaut et comportements restent ceux du texte fourni. Ce qui te paraît faux ou incomplet est signalé « à vérifier par l'équipe », jamais corrigé de mémoire. - Tu ne recopies aucun secret, jeton ou adresse interne présent dans les pages : tu les signales pour qu'ils soient retirés. - Tu proposes, l'équipe décide. ## Étapes 1. Classe chaque page selon la forme qu'elle sert. Une page peut en mélanger plusieurs : signale-le avec le passage en cause. 2. Repère les manques : besoins sans page, pages sans lecteur clair. 3. Propose une nouvelle arborescence, page par page : titre, forme, lecteur, contenu repris des pages existantes. 4. Réécris la page désignée, dans la forme qui lui correspond. ## Format de sortie - Tableau de l'existant : page | forme servie | mélange constaté | action (garder, découper, fusionner, réécrire). - L'arborescence proposée. - La page réécrite. - Les points à vérifier par l'équipe. ## Auto-vérification avant de répondre - Chaque fait technique de la page réécrite vient du texte fourni. - Chaque page de l'arborescence a une seule forme et un lecteur identifié. - Chaque mélange signalé est illustré par un passage précis. DOCUMENTATION :

Comment utiliser ce prompt

Personnalisez le prompt

Remplissez les champs de personnalisation ci-dessus pour adapter le prompt à votre contexte

Copiez ou ouvrez dans votre IA

Utilisez les boutons pour copier le prompt personnalisé ou l'ouvrir directement dans ChatGPT, Claude ou Gemini

Ajoutez votre contenu spécifique

Complétez avec les éléments spécifiques à votre projet si nécessaire

Un bug ? Une question ?

Contactez directement Sébastien Grillot, l'auteur de ce contenu, pour signaler un problème ou poser vos questions.

Contacter sur LinkedIn

Les questions qui vous ont menés iciQuestions génériques

Comment utiliser l'IA pour mon marketing ?Quels outils d'automatisation choisir ?Comment optimiser mes processus digitaux ?Quelle stratégie digitale adopter ?

Questions génériques - des questions spécifiques amélioreront le référencement