1Ce que le KIT produit
Vous décrivez votre sujet à une intelligence artificielle. Elle applique des règles de présentation déjà écrites et produit trois formats: des fichiers Word, des PDF, et les pages d’un site web.
Le contenu est saisi une fois; les trois formats en découlent. L’assistant d’intelligence artificielle — Claude, Gemini, Grok ou un autre — est celui de votre choix: le KIT définit les règles et la chaîne de production, il ne dépend d’aucun fournisseur. Il masque aussi la technique, et vous vous concentrez sur votre documentation.
Trois questions se tranchent avant la première ligne: elles déterminent l’organisation du contenu, et les reprendre plus tard impose une réécriture.
2Pour qui écrivez-vous
Le public détermine le vocabulaire, le niveau de détail et ce qui peut être supposé connu.
–Des gens du métier. Votre vocabulaire s’emploie tel quel. Le document est dense et court.
–Des gens qui découvrent. Les termes se définissent, l’exemple précède la règle. Le document est plus long et progressif.
–Vous-même, dans deux ans. Vous écrivez ce que vous aurez oublié: le motif d’un choix, ce qui avait été essayé avant.
Un document écrit pour deux de ces publics est trop détaillé pour l’un et trop elliptique pour l’autre. Un public par document.
3Sous quelle forme
Deux formes de lecture. Le classeur papier impose un ordre, une pagination et une page de garde; il se lit sans équipement. Le site se met à jour en une opération, se cherche par mot-clé et se partage par un lien.
Les deux se produisent depuis la même source.
4Dans quelle langue
Une ou plusieurs. Le KIT produit les variantes et les publie côte à côte, avec un sélecteur de langue sur le site.
Prévu au départ, ce point tient en une ligne de configuration. Ajouté ensuite, il impose de reprendre chaque document et de désigner la version qui fait autorité.
5Deux astuces qui faciliteront la gestion de votre documentation
–Un nom de fichier parlant. La règle importe peu; ce qui compte est de reconnaître un fichier sans l’ouvrir. Le KIT rajoute la date et l’heure dans chaque nom, ce qui facilite la gestion des versions.
–Un seul document fait foi. Deux fichiers finiront par se contredire — c’est normal dans un projet qui évolue. Une fois l’écart détecté, dites à l’assistant lequel des deux est la source; les autres s’ajustent.
6Ce que vous publiez
Une partie de votre documentation reste interne: notes de travail, listes de tâches, éléments non stabilisés. Le statut se décide document par document, au moment de sa création.
Un document non publié reste dans le classeur et n’apparaît pas sur le site. Une publication se rattrape mal: un contenu mis en ligne a pu être consulté, copié ou indexé avant son retrait.
7Travailler avec une intelligence artificielle
Elle écrit la mise en forme, produit les fichiers et tient les conventions. Vous apportez le contenu.
Aucun assistant n’est parfait aujourd’hui: il y aura des formulations maladroites, voire des fautes. Relisez toujours ce qu’il produit avec les yeux du lecteur que vous visez, et apprenez-lui à s’adapter.
8Aller plus loin
La présentation du KIT ne vous conviendra peut-être pas — pas de problème. Vous pouvez adapter les formatages et ajouter vos mises en page en parallèle, sans modifier l’original. Vous pouvez ainsi continuer à recevoir les mises à jour sans écraser vos extensions. La marche à suivre est décrite dans Étendre le Kit.
9Si vous voulez lancer…
Le KIT se télécharge sous forme d’un fichier ZIP depuis le site kit.sliver.lu — l’icône en haut à droite de la page d’accueil.
Le guide d’initialisation décrit la suite.