Expertise
L'expertise d'Olivier Carrère, rédacteur technique senior (docs-as-code, DITA et rédaction structurée, architecture documentaire, documentation développeur et automatisation CI/CD), démontrée par une sélection de projets documentaires, d'études de cas et de travaux techniques.
Travaux choisis
Section intitulée « Travaux choisis »Projets documentaires qui démontrent les domaines d’expertise ci-dessous.
Documentation de NuFirewall (DITA XML)
Documentation d'un produit logiciel citée par la presse comme un point fort du produit : stratégie de réutilisation par conref, texte conditionnel, sources prêtes pour la traduction.
Ce portfolio, un projet docs-as-code
Documentation bilingue FR/EN sous Git depuis 2014 : reStructuredText et DITA XML, aujourd'hui Astro et Starlight, compilée en CI à chaque modification.
Une API documentaire lisible par les machines
Les mêmes sources Markdown servies aux scripts et agents IA (llms.txt, miroirs Markdown, index JSON), générées à la compilation.
DITA XML sur des projets multilingues
Solutions et astuces issues de l'usage quotidien de DITA XML sur des projets de documentation technique multilingues.
Docs-as-code
Section intitulée « Docs-as-code »Intégrer la documentation aux workflows d’ingénierie, avec les mêmes outils et le même cycle de vie que le produit.
Documentation sélectionnée
- Intégrer la documentation aux processus de développement
- Les systèmes de gestion de versions - rustiques mais fiables
- Git : du fichier au contenu
- Utiliser les branches des systèmes de gestion de sources
- Un référentiel unique ?
- Référentiel
- Quel référentiel pour le travail de groupe ?
- Exemple : un workflow docs-as-code basique
- Exemple : un workflow de revue documentaire
- Check-list : adoption du docs-as-code
DITA et rédaction structurée
Section intitulée « DITA et rédaction structurée »Déterminer le degré de structure dont le contenu a besoin, puis construire des sources modulaires et réutilisables en DITA XML.
Documentation sélectionnée
- Cas concret : documentation de NuFirewall : stratégie de réutilisation et de traduction sur un produit logiciel.
- Cas concrets d’utilisation de DITA XML
- Formats structurés et non structurés
- Format structuré DITA XML
- Une architecture documentaire trop complexe ?
- Formats et outils
- Format source
- Didacticiels DITA XML et XSL-FO
Architecture documentaire
Section intitulée « Architecture documentaire »Structurer des ensembles documentaires pour qu’ils passent à l’échelle et restent cohérents en grandissant.
Documentation sélectionnée
Documentation développeur et d’API
Section intitulée « Documentation développeur et d’API »La documentation destinée à ceux qui construisent sur un produit, maintenue exacte par les tests produit et les revues techniques.
Documentation sélectionnée
- Modèle : documentation d’API
- À propos de l’API de ce manuel : une API documentaire statique et opérationnelle pour les scripts et agents IA.
- Tester les produits pour les documenter
- Collecte de l’information : travailler avec les ingénieurs et autres experts métier.
- Check-list : revue technique
- Modèle : demande de revue documentaire
Automatisation et CI/CD
Section intitulée « Automatisation et CI/CD »Compiler, vérifier et publier la documentation automatiquement, et générer le contenu à partir des données plutôt que de le recopier à la main.
Documentation sélectionnée
- Exemple : un pipeline CI/CD concret pour la documentation
- Insérer automatiquement des données dans un fichier DITA XML
- Insérer automatiquement des données SQL dans un fichier reStructuredText
- Insérer automatiquement des données dans un fichier reStructuredText
- Créer des documents différents à partir des mêmes sources via Jinja et par la méthode objet
- Créer des documents différents à partir des mêmes sources ReST (texte conditionnel)
- Expressions régulières en Python
- sed : modifiez votre texte sans ouvrir vos fichiers
- Le Raspberry Pi 3 en tant que plateforme de documentation
- Mener un projet de bout en bout
- Format cible : publication multiformat (PDF, HTML, EPUB) à partir d’une source unique.
Documentation assistée par l’IA
Section intitulée « Documentation assistée par l’IA »Utiliser l’IA dans une composante du workflow documentaire, toujours avec une relecture humaine : traduction, assistant documentaire fondé sur les pages de ce portfolio et API documentaire lisible par les scripts et les agents IA.
Documentation sélectionnée
- Interroger la documentation : un assistant qui répond uniquement à partir des pages de ce portfolio, et cite les pages utilisées.
- L’API documentaire : llms.txt, miroirs Markdown et index JSON générés à la compilation pour les scripts et les agents IA.
- Translating legacy French docs to English with DeepL and GPT-4o (en anglais) : le workflow utilisé pour traduire ce portfolio, avec les diffs Git comme filet de sécurité.
- Reliability vs. latency: running Claude through the CLI (en anglais) : boucler la boucle de rétroaction pour que le modèle corrige ses propres erreurs de compilation.
- Persona prompting: check this before printing (en anglais) : une revue technique structurée obtenue par un prompt ciblé.
Processus documentaire et qualité
Section intitulée « Processus documentaire et qualité »Mener la documentation comme un processus explicite et reproductible, de la définition du projet à la livraison, avec des contrôles qualité à chaque étape.
Documentation sélectionnée
- Rédaction technique : un processus industriel
- Définition du projet et le modèle de plan de projet
- Création du contenu
- Validation et contrôle qualité
- Livraison
- Check-lists : qualité documentaire, préparation à la mise en production, audit documentaire et migration documentaire
- Documentation technique : diminuer les coûts, améliorer la satisfaction client
- De la rédaction à la communication technique
- Principe de simplicité KISS
Documentation multilingue
Section intitulée « Documentation multilingue »Planifier la traduction dès le début du projet, et structurer les sources pour que la traduction reste abordable. Je suis diplômé d’une école de traduction et j’ai plusieurs années d’expérience en traduction technique.
Documentation sélectionnée
- Traduction
- Utiliser les branches des systèmes de gestion de sources : branches linguistiques parallèles.
- Cas concret : documentation de NuFirewall : traduire du contenu DITA XML fondé sur les conrefs.
Outils et formats
Section intitulée « Outils et formats »Outils et formats abordés dans ces articles, ou utilisés pour construire ce site :
Me contacter
Section intitulée « Me contacter »Pour échanger sur un poste ou un projet de rédaction technique, contactez-moi sur LinkedIn. Plus d’informations dans mon profil professionnel ↗ (en anglais) et sur la page À propos.