L'écrivain technique natif de l'IA

L'IA transforme plus que la manière dont les écrivains techniques rédigent du contenu. Elle modifie la façon dont nous recherchons, créons, structurons, examinons, maintenons et mesurons la documentation, tout en changeant le rôle de l'écrivain technique lui-même. Cette rencontre explorera des moyens pratiques permettant aux rédacteurs techniques d'incorporer l'IA dans leurs flux de travail, des outils de documentation alimentés par l'IA et des compétences aux nouvelles approches pour organiser et maintenir le contenu. Intervenant confirmé Ane Tröger, PhDResponsable technique chez BayerTalk : Construire une compétence de classification Diátaxis pour Docs-as-CodeDescription : Dans les dépôts de docs-as-code internes, la documentation tend à croître de manière organique, plutôt que par conception. Des pages sont ajoutées là où c'est pratique plutôt que là où elles appartiennent, et le résultat est une structure plate et non typée que personne ne comprend entièrement. Les migrations de plateforme aggravent la situation : la hiérarchie existante s'effondre partiellement, et le contenu arrive par lots. Le coût retombe sur tout le monde : les lecteurs perdent du temps dans le mauvais mode, les écrivains perdent confiance quant à l'endroit où va leur contribution, et les outils d'IA perdent en précision car des signaux mélangés produisent des sorties mélangées. Une solution possible consiste à restructurer le dépôt afin qu'il soit plus facile de trouver des informations, plus facile à maintenir, et potentiellement plus facile à consommer pour l'IA. Cette présentation propose de construire une compétence IA qui classe les pages de documentation selon le cadre Diátaxis — tutoriel, mode d'emploi, explication et référence — plus un cinquième type, l'orientation, ajouté pour gérer les hubs de navigation que tout dépôt réel contient. Nous examinerons comment la compétence est structurée à travers trois fichiers, le flux de travail en quatre étapes qu'elle suit (lire, classer, diviser, naviguer), et pourquoi elle produit un niveau de confiance basé sur la distribution des signaux plutôt que sur un verdict de réussite/échec — avec une confiance faible agissant comme drapeau de contenu mélangé. Convient aux écrivains techniques à tous les niveaux ; les sections sur la conception des compétences et la prise de décision vont plus loin pour les praticiens expérimentés. Les fondations du cadre Diátaxis et des exemples seront abordés brièvement, et si vous voulez tirer le meilleur parti de cette présentation, je vous suggère de jeter un œil au cadre Diátaxis à l'avance : https://diataxis.fr/start-here/ Frances LiuCo-fondatrice, Promptless Présentation : Ce que les agents IA se trompent en rédigeant des docs Description : Nous testons régulièrement des agents de pointe (Claude Code, Codex et OpenCode avec des modèles ouverts) sur des tâches de documentation. Les brouillons reviennent généralement polis et cohérents, mais leurs échecs ont eu lieu avant la rédaction : décider si un changement nécessitait des docs, déterminer pour qui étaient les docs, choisir quelle page le changement concernait, et répondre à ce que le lecteur devait faire plutôt que de décrire ce que fait la fonctionnalité. Nous passerons en revue quels agents réussissent sur quels types de tâches, quel contexte augmente leurs chances de succès et comment examiner leur sortie afin que les échecs silencieux n'atteignent pas vos lecteurs. Vous repartirez avec une liste de contrôle pour décider quoi remettre à un agent, et quoi vérifier lorsqu'il vous rend son travail.Helena JerneyResponsable de l'expérience informationnelle chez StreetLight Data Présentation : Architecture de l'information pour le public de l'IADescription : Ce qu'il faut pour que le contenu soit consommé par l'IA afin de permettre une expérience utilisateur optimale. Où le contenu et l'architecture contextuelle se rencontrent et comment gérer le pipeline d'information pour répondre aux besoins et limitations des LLM.