Rédacteur technique / ingénieur documentation

Entretiens semi-directifs avec 31 rédacteurs techniques expérimentés travaillant dans des start-up, de grandes entreprises et des projets open source. Les auteurs décrivent cinq étapes de relecture : 28 participants ont décrit la relecture technique par des ingénieurs ou d'autres experts du sujet, qui fait remonter un savoir écrit nulle part ailleurs ; 13 ont décrit le « play testing », où des personnes qui connaissent le produit mais n'ont pas écrit la documentation la suivent de bout en bout pour trouver ce que le rédacteur, trop proche, ne voit pas, surtout pour les tutoriels ; et 25 ont décrit les retours de relecture générés par des LLM comme peu fiables, en partie parce que le contexte dont une relecture a besoin se trouve dans des systèmes internes confidentiels qu'ils ne peuvent pas partager avec les fournisseurs de modèles. Les rédacteurs indiquent qu'ils n'ont aucune autorité pour imposer une relecture et doivent la négocier. C'est une étude qualitative de pratiques auto-déclarées ; une personne parmi les auteurs travaille dans une entreprise qui vend des modèles de langage.

Usage mesuré et à grande échelle d'un outil pour du travail réel, où la décision de l'utiliser vient de la personne qui travaille et non de l'employeur. C'est plus qu'un enregistrement de capacité — le travail est réel, pas une démonstration — et moins qu'un enregistrement de déploiement, car aucun employeur ne l'a mis en production, ne l'a exigé, ni n'a construit un processus autour. Pondéré `cautious` : `automating` signifie que la machine sait faire la tâche ET qu'il y a des signes d'adoption, et ceci est un signe d'adoption ; mais l'usage peut être expérimental, et une bonne part de la mesure vient d'une partie intéressée, donc un enregistrement ne suffit jamais et deux indépendants suffisent. Regardez qui compte. La télémétrie d'un fournisseur voit cela directement et vend l'outil, donc un tel enregistrement déclare cet intérêt dans son périmètre ; une agence statistique qui demande aux entreprises si leurs salariés utilisent l'IA dans leurs tâches voit le même canal sans aucun intérêt propre, et là où elle existe, c'est la meilleure source.

Le guide de la FDA destiné aux fabricants de dispositifs médicaux, signalé comme contenant des recommandations non contraignantes. Il couvre l'étiquetage, y compris les notices d'utilisation, les manuels d'utilisation, les notices jointes à l'emballage et les guides de démarrage rapide, et indique que les tests de validation des facteurs humains peuvent évaluer l'adéquation de la notice d'utilisation, mais seulement dans le contexte d'utilisation du dispositif ; que la considération la plus importante pour les participants aux tests est qu'ils représentent la population des utilisateurs prévus ; et que si les tests révèlent des erreurs d'utilisation sur des tâches critiques, affirmer que le risque a été atténué en modifiant la notice ou un autre élément d'étiquetage n'est pas acceptable sans données de test supplémentaires montrant que la modification a fonctionné. Il ne s'applique qu'aux dispositifs médicaux et ne dit pas qui rédige la notice.

Un échec, un retour en arrière, une réglementation ou un coût freine l'adoption. Cela peut abaisser une appréciation ou élargir son incertitude.

Lu article par article sur le portail du ministère de la Législation, dans la version en vigueur depuis le 21 juillet 2026. Deux alinéas de l'article 34(1) touchent ce métier et ils font des choses différentes. L'alinéa 2 exige de l'exploitant qu'il établisse et mette en oeuvre un plan pour expliquer — dans la mesure du techniquement possible — le résultat final produit par l'IA, les principaux critères utilisés pour y parvenir, et un aperçu des données d'entraînement utilisées pour la développer et l'exploiter. L'alinéa 5 exige la rédaction et la conservation de documents par lesquels le contenu des mesures de sûreté et de fiabilité peut être vérifié. Le premier gouverne ce qu'une référence doit couvrir ; le second retire la latitude d'omettre quelque chose. L'article 36(1)(3) pose ensuite la question de l'entretien plutôt que de la rédaction : un exploitant étranger au-dessus de seuils d'usagers ou de chiffre d'affaires doit désigner un représentant national dont les devoirs incluent l'appui à la conformité à l'article 34(1), y compris expressément la vérification de l'actualité et de l'exactitude de ces documents. Deux limites. La loi renvoie le détail à un décret présidentiel et à un avis ministériel, et l'article 34(2) dit que le ministre peut recommander la conformité à cet avis — la précision de ce qui doit être écrit n'est donc pas fixée par cet enregistrement. Et cela ne lie que les exploitants d'IA à fort impact en Corée ; rien ici ne compte un rédacteur technique, un document ou une heure.

Une réglementation, une subvention ou une commande publique exige ou finance l'adoption — le miroir d'une contrainte. Cela montre que l'adoption est exigée, non qu'elle a eu lieu, donc une impulsion ne suffit jamais à elle seule ; deux indépendantes suffisent.

Représentatif à l'échelle nationale, période de référence de novembre 2025 à janvier 2026. C'est la couche « tâches des salariés » du même supplément plutôt que sa couche « adoption par l'entreprise » : 23 % des entreprises (41 % pondéré par l'emploi) déclarent des salariés utilisant l'IA dans des tâches professionnelles, et parmi les tâches rapportées, l'écriture, l'analyse de documents et la recherche d'information viennent en tête. C'est un décompte d'entreprises rapportant une tâche, non une mesure de la part de l'écriture faite ainsi, et cela ne distingue pas la documentation technique d'un autre écrit — personne n'a demandé ce qui était écrit. Sa valeur ici est ce qu'il n'est pas : contrairement à la télémétrie d'un éditeur, c'est une agence statistique qui compte le même canal sans intérêt dans la réponse, ce qui en fait la meilleure source sur l'adoption par les travailleurs là où elle existe.

Usage mesuré et à grande échelle d'un outil pour du travail réel, où la décision de l'utiliser vient de la personne qui travaille et non de l'employeur. C'est plus qu'un enregistrement de capacité — le travail est réel, pas une démonstration — et moins qu'un enregistrement de déploiement, car aucun employeur ne l'a mis en production, ne l'a exigé, ni n'a construit un processus autour. Pondéré `cautious` : `automating` signifie que la machine sait faire la tâche ET qu'il y a des signes d'adoption, et ceci est un signe d'adoption ; mais l'usage peut être expérimental, et une bonne part de la mesure vient d'une partie intéressée, donc un enregistrement ne suffit jamais et deux indépendants suffisent. Regardez qui compte. La télémétrie d'un fournisseur voit cela directement et vend l'outil, donc un tel enregistrement déclare cet intérêt dans son périmètre ; une agence statistique qui demande aux entreprises si leurs salariés utilisent l'IA dans leurs tâches voit le même canal sans aucun intérêt propre, et là où elle existe, c'est la meilleure source.

La tâche qui vous embauchait — produire la référence — est la tâche d'écriture la plus exposée de ce site. Celle qui est désormais rare est celle pour laquelle personne ne recrute directement : être la personne qui ne sait pas, qui suit les instructions, et qui trouve l'étape impossible. Rendez cela visible dans votre manière de travailler, parce que c'est le seul argument qui survit à une rédaction bon marché.

Votre équipe sera mesurée sur la couverture, et la couverture vient de devenir gratuite : l'indicateur aura donc l'air excellent pendant que la documentation empire d'une manière qu'aucun tableau de bord ne montre. Le chiffre à mettre devant un responsable est le nombre de tickets de support sur les dix pages les plus lues, parce que c'est la seule mesure qui bouge quand la documentation est réellement bonne.

Refaçonner le poste

Devenez le premier utilisateur, officiellement

La seule entrée documentaire qu'un modèle ne peut pas avoir est l'expérience d'être perdu, et une équipe qui livre vite a besoin de quelqu'un dont le métier est d'être perdu exprès avant que les clients ne le soient.

Mouvement latéral

Passez à la documentation qui est une pièce de conformité

Dans les domaines réglementés le document est exigé par une règle (la loi coréenne sur l'IA oblige les opérateurs à fort impact à rédiger et conserver des documents attestant leurs mesures de sécurité) : il est donc tenu en place par la loi plutôt que par un budget.

Rédiger la référence est la tâche d'écriture la plus exposée de ce site, parce que la source de vérité est lisible par machine et le format de sortie est fixe — et les générateurs de documentation en avaient déjà pris une part bien avant les modèles. Ce qui ne bouge pas est l'épreuve : suivre ses propres instructions sur une machine vierge et trouver l'étape qui est impossible pour tous ceux qui ne sont pas l'ingénieur. Un modèle entraîné sur la base de code hérite exactement du savoir qui doit être absent pour que cette épreuve fonctionne.

Pas de date. Le signal est ce sur quoi votre équipe est mesurée. S'il s'agit des pages publiées ou de la couverture, l'indicateur vient de devenir gratuit et aura l'air excellent pendant que la documentation empire — et les décisions d'effectifs se prennent sur ce tableau de bord. Regardez si quelqu'un suit les tickets de support page par page, parce que c'est la seule mesure qui bouge quand la documentation est réellement bonne, et son existence vous dit comment se passera le prochain budget.

Elle a cessé de l'être au moment où la production est devenue bon marché, et c'est le changement le plus lourd de conséquences dans ce métier. La couverture mesure désormais la quantité de texte qui existe plutôt que la capacité de quiconque à en faire quelque chose : une équipe jugée sur la couverture sera donc récompensée d'abandonner la tâche qui vient de devenir l'importante — décider ce qu'on n'écrit pas. Si votre équipe rapporte encore la couverture, soulever ce point vaut plus que d'écrire une page de plus.

Nettement, et c'est l'exemple le plus clair de cette page d'une tâche tenue en place par autre chose que le coût. Dans les dispositifs médicaux, les instructions sont jugées sur la façon dont des utilisateurs représentatifs se servent de l'appareil, et les lignes directrices de la FDA disent que corriger un problème d'utilisation en les réécrivant n'est pas acceptable sans nouvelles données d'essai, ce qui veut dire que le travail ne peut pas être simplement produit et publié. C'est une protection réglementaire plutôt que technique — durable exactement aussi longtemps que la règle tient — mais elle est réelle aujourd'hui.