⏱️ L'essentiel en 3 minutes

• Un document performant traite un seul sujet, se résume en un titre court et précis, et ne contient que des informations à jour.
• Les redondances entre documents font concurrence aux informations complémentaires et dégradent la pertinence des réponses.
• Les droits d'accès doivent correspondre au périmètre réel des utilisateurs concernés pour éviter les interférences.
• Quatre questions à se poser avant chaque import : sujet unique ? informations valables ? pas de doublons ? accès appropriés ?

🧠 Comprendre l'enjeu pédagogique de la structure documentaire

L'IA Didask ne "lit" pas un document comme un humain : elle compare chaque question à l'ensemble de votre base et sélectionne les passages les plus proches du besoin de l'apprenant. Un document mal structuré, trop long, trop vague, ou redondant avec d'autres sera difficile à retrouver, même s'il contient la bonne réponse.

Soigner la structure de vos documents, c'est permettre à l'IA de localiser précisément ce dont chaque collaborateur a besoin au bon moment. C'est aussi une façon de garantir que vos connaissances métier sont transmises avec fidélité, sans bruit ni ambiguïté.

✅ Évaluer un document avant de l'ajouter à la base

Avant tout import, posez-vous ces quatre questions :

Question	Si la réponse est non...
Puis-je résumer ce document en un titre court et précis ?	Le document traite probablement de trop de sujets : le découper.
Toutes les informations sont-elles encore valables ?	Nettoyer le document ou ne pas l'inclure.
Y a-t-il d'autres documents dans la base qui disent la même chose ?	Supprimer les parties communes ou fusionner les documents.
Ce document est-il utile à tous les utilisateurs qui ont accès à cette base ?	Restreindre l'accès ou séparer en bases distinctes.

📌 Respecter la règle : un document, un seul sujet

Un document qui traite plusieurs sujets à la fois sera difficile à associer à une question précise. L'IA aura du mal à l'identifier comme la source la plus pertinente, même s'il contient la bonne information.

Le signe révélateur : vous avez du mal à lui donner un titre court et précis.

Bon exemple : "Processus de validation d'un devis client" qui explique uniquement les étapes de validation, les interlocuteurs et les délais.
À éviter : "Réunion équipe commerciale du 12 mars" qui aborde à la fois la validation des devis, un point RH, la stratégie Q3 et un post-mortem de bug.

Que faire : découpez le document en autant de documents qu'il y a de sujets distincts. Chaque document doit avoir un titre qui résume son contenu en une phrase courte.

🧹 Supprimer les informations obsolètes

L'IA ne peut pas distinguer ce qui est encore valable de ce qui est périmé. Une information ancienne peut rendre la bonne information plus difficile à trouver, voire provoquer des réponses incorrectes.

Bon exemple : une politique de remboursement des frais à jour, contenant uniquement les règles actuellement en vigueur.
À éviter : le même document auquel on a ajouté les nouvelles règles en bas, sans supprimer les anciennes. L'IA ne sait pas lesquelles sont valides.

Que faire : extraire uniquement les parties encore valables et créez un nouveau document propre. Si un document est trop pollué pour être nettoyé facilement, mieux vaut ne pas l'inclure. Moins de documents, mais de meilleure qualité, donne de meilleures performances.

🔁 Éviter les redondances entre documents

Si plusieurs documents abordent le même sujet avec des mots différents, l'IA les fera remonter simultanément. Ces doublons occupent la place de connaissances complémentaires potentiellement plus utiles, et les parties communes masquent les spécificités de chaque document.

Bon exemple : deux documents sur le même outil, l'un intitulé "Guide technique de l'outil X pour les développeurs", l'autre "Utiliser l'outil X au quotidien pour les équipes métier". Chacun va directement à ce qui est spécifique à sa cible, sans introduction commune.
À éviter : trois versions d'une documentation sur la même fonctionnalité (marketing, support, développeurs) qui commencent toutes par les mêmes deux paragraphes de présentation générale.

Que faire : supprimez les parties communes, ou isolez-les dans un document dédié auquel vous faites référence. Distinguez clairement les documents dans leur titre ("version technique" ou "version vulgarisée").

🔒 Adapter les droits d'accès selon les utilisateurs

Tous les apprenants n'ont pas besoin de toutes les connaissances. Des documents très techniques destinés à un petit groupe peuvent parasiter les réponses des autres utilisateurs dont les questions emploient des mots proches.

Bon exemple : la documentation technique sur l'architecture du produit est accessible uniquement aux équipes R&D. Les équipes commerciales ont accès à une base séparée avec les fiches produits et les argumentaires.
À éviter : une base accessible à tous qui mélange des transcripts de calls clients, des spécifications techniques internes et des guides d'onboarding.

Que faire : définissez des groupes d'utilisateurs et attribuez les documents en conséquence. Construisez la base progressivement : ajoutez un document quand un groupe exprime un besoin réel, pas par anticipation.

🖼️ Structurer le format pour faciliter la lecture par l'IA

📝 Décrire les tableaux, images et schémas en texte

L'IA s'appuie sur le texte : un tableau, une image ou un schéma sans description écrite est en grande partie invisible pour elle, même si l'information y est clairement présentée pour un humain.

Que faire : sous chaque tableau, image ou schéma, ajoutez une ou deux phrases qui en résument le contenu et la conclusion à retenir. Cette description doit pouvoir se suffire à elle-même, sans que le lecteur ait besoin de regarder le visuel.

📊 Garder chaque tableau complet sur une seule page

Un tableau coupé entre deux pages, ou dont une partie déborde hors champ, peut être lu de façon incomplète par l'IA : certaines lignes ou colonnes risquent d'être ignorées.

Que faire : si un tableau est trop long ou trop large pour tenir sur une seule page, réduisez son contenu aux colonnes essentielles, ou transformez-le en liste de puces. Un tableau court et complet vaut mieux qu'un tableau exhaustif mais tronqué.

🔗 Écrire les liens en toutes lettres

Un lien caché derrière "cliquez ici" ou "en savoir plus", ou affiché uniquement sous forme d'hyperlien cliquable, ne donne à l'IA aucune information exploitable sur sa destination. Si un lien mérite d'être inclus, il doit préciser vers quoi il renvoie et afficher son adresse complète en texte, pas seulement en hyperlien.

Que faire : indiquez le titre de la page ou du document visé, puis écrivez l'adresse complète du lien.

🔠 Hiérarchiser titres et sous-titres avec les styles natifs de votre éditeur

L'IA s'appuie sur les titres structurés nativement dans l'éditeur de texte (styles Titre 1, Titre 2, etc.), pas seulement sur la présentation visuelle. Sans ce balisage, elle doit deviner la structure du contenu.

Que faire : utilisez les styles de titres natifs de votre éditeur, avec un titre principal (H1) unique, puis des sous-titres (H2, H3) qui reflètent le découpage réel du contenu. Chaque section doit pouvoir se comprendre à partir de son titre seul.

Mots-clés : structure documentaire, base de connaissances, IA Didask, qualité des documents, performance, redondances, droits d'accès

📄 Structurer mes documents pour optimiser les performances de l'IA Didask