Utilisez cette liste de contrôle avant de publier un article pour vérifier qu’il répond aux normes de lisibilité humaine et de récupérabilité par IA. Chaque élément correspond à une bonne pratique couverte dans le contenu compatible avec Gen AI.
Structure et titres
- Les titres H1, H2 et H3 sont utilisés hiérarchiquement, aucun niveau n’est sauté.
- Chaque titre est descriptif et spécifique, pas générique (évitez « Aperçu », « Introduction », « Détails »).
- Aucun titre n’est répété dans le même article.
- Les mots-clés pertinents apparaissent naturellement dans les titres.
Paragraphes et déroulement
- Les phrases sont courtes. Idéalement, moins de 20 mots et direct.
- Chaque paragraphe couvre une seule idée ou tâche.
- Le remplissage, le contexte de fond et les informations tangentes sont supprimés ou reliés séparément.
- Chaque section est modulaire et concise. Idéalement moins de 500 jetons (~375 mots).
Listes & tableaux
- Les points clés sont utilisés pour des informations groupées et non ordonnées.
- Les listes numérotées sont utilisées pour des étapes séquentielles.
- Les listes contiennent de 3 à 7 éléments et chaque élément est parallèle dans sa structure.
- Les tables sont utilisées pour les données structurées (paramètres, paramètres, comparaisons).
- Toutes les colonnes du tableau ont des en-têtes descriptifs.
- Toutes les cellules du tableau contiennent du texte descriptif. Pas de Y/N, pas de tirets, d’emojis ou d’icônes.
- Pas de cellules fusionnées ni de formatage de tableau incohérent.
Extraits de code
- Le code est propre, constamment indenté et correctement formaté.
- Les commentaires en ligne expliquent la logique et l’intention.
- Des surlignages de syntaxe ou des balises de langue sont appliqués.
- Les blocs de code sont copiables. Pas de numéros de ligne ni de style décoratif.
- Une instruction de contexte est incluse pour le code API ou au produit.
Images et liens
- Chaque image a un texte alternatif significatif et descriptif.
- Le texte alternatif évite les étiquettes vagues comme « capture d’écran ».
- Les légendes ou le texte environnant apportent un contexte supplémentaire lorsque nécessaire.
- Tout le texte d’ancrage est descriptif. Par exemple, « Apprenez à gérer les espaces de travail privés » au lieu de « ici », « ceci » ou « cliquez ici ».
- Les liens internes relient à des articles connexes lorsque c’est pertinent.
SEO & métadonnées
- Les mots-clés apparaissent naturellement dans les titres, les ouvertures de section et le corps du texte clé.
- Une méta-description est rédigée avec les mots-clés principaux de l’article.
- Les métadonnées structurées (étiquette de titre, description, champs personnalisés) sont appliquées lorsque cela est supporté.
- La terminologie est conforme aux termes approuvés par le glossaire.
Compétences et flux de travail IA
- Si un SKILL.md a été utilisé, le résultat a été examiné pour sa précision et sa complétude avant publication.
- Aucune section n’a été sautée sans raison. Si une section est omise, elle n’est vraiment pas applicable.
- La voix et le ton correspondent aux conventions MSTP : deuxième personne, présent, voix active, pas de langage marketing.
- Les FAQ produites par la compétence sont autonomes et proviennent de questions réelles des utilisateurs, et non de remplissage généré.
GEO (Optimisation des moteurs génératifs)
- L’article s’ouvre sur une réponse directe à la question principale de l’utilisateur dans les deux premières phrases.
- Chaque section est autonome et prend sens lorsqu’elle est lue isolément, sans nécessiter de contexte environnant.
- Les termes clés et définitions sont explicitement énoncés, et non supposés à partir du contexte.
- Aucune information cruciale n’est enfouie au milieu d’un long paragraphe — mettez-la en valeur dans un titre, une liste ou un signalement.
- Le contenu est structuré de manière à ce que l’IA puisse extraire une réponse utilisable sans avoir lu l’article en entier.
Glossaire et terminologie
- Les termes de glossaire approuvés sont utilisés exactement tels que définis. Pas de synonymes ni de variations.
- Des termes inconnus sont définis ou liés dès la première mention.
- Les abréviations et acronymes sont utilisés de façon constante tout au long du texte.
Style d’écriture
- Le ton est clair, conversationnel et convivial.
- Un langage simple est utilisé ; Le jargon est évité ou expliqué.
- La deuxième personne (« vous ») est utilisée dans les contenus pédagogiques et pratiques.
FAQ
- L’article comprend 5 à 10 FAQ dans une section dédiée.
- Les questions proviennent de véritables demandes d’utilisateurs, de tickets de support ou de questions courantes sur les produits.
- Chaque réponse FAQ est autonome et concise.
Tests spécifiques à l’IA
- Des brouillons générés par l’IA sont examinés pour leur exactitude, leur ton et leurs hallucinations.
- L’article a été testé dans Eddy AI pour confirmer des réponses exactes.
- Le contenu est suffisamment modulaire pour être réutilisé dans les FAQ, les réponses par chat et les résumés.
- Les questions sans réponse ou les retours de soutien ont été examinés et intégrés.