# À propos d’Olivier Carrère

Je rédige la documentation de produits logiciels et des équipes d'ingénierie qui les construisent. Ce site est ma pratique de la rédaction technique : un guide pratique pour concevoir, rédiger, maintenir et publier de la documentation technique, fondé sur mes méthodes, mes projets et mon expérience. Je le maintiens comme un projet docs-as-code. Mon [profil professionnel](https://redaction-technique.org/) ↗ (en anglais) résume mon expertise et mes travaux choisis, et publie mes articles.

> **Note**
>
> Cette page comporte deux parties : [à propos de moi](#à-propos-de-moi), avec mon profil, ma démarche, ma disponibilité et mes coordonnées, et [comment ce site est construit](#comment-ce-site-est-construit), son colophon.

## À propos de moi

### Profil

- **Documentation de produits logiciels.** J'ai rédigé la [documentation de NuFirewall](https://docs.redaction-technique.org/fr/formats/nufirewall-case-study/) en DITA XML ; la presse l'a citée comme un point fort du produit.
- **Rédaction structurée.** J'ai utilisé [DITA XML au quotidien sur des projets multilingues](https://docs.redaction-technique.org/fr/formats/dita-xml-case-studies/) : typage des topics, réutilisation du contenu par conref, texte conditionnel et sources prêtes pour la traduction.
- **Docs-as-code.** Ce site est rédigé, versionné et publié à partir de [Git](https://github.com/olivier-carrere/redaction-technique.org/) depuis 2014, à travers plusieurs formats sources et chaînes de publication.
- **Traduction.** Diplômé d'une école de traduction, j'ai plusieurs années d'expérience en traduction technique, ce qui oriente la façon dont je structure le contenu pour la localisation.

### Ma démarche documentaire au sein des équipes d'ingénierie

- La documentation sort avec le produit, suit le même cycle de vie et passe par le même contrôle qualité : voir [intégrer la documentation aux processus de développement](https://docs.redaction-technique.org/fr/tech-writing-process/integrating-documentation-into-development/).
- Je teste le produit en conditions réelles d'utilisation avant de le documenter, plutôt que de compiler ce que l'on me dit : voir [tester les produits pour les documenter](https://docs.redaction-technique.org/fr/tech-writing-process/testing-products/).
- Je collecte l'information auprès des ingénieurs et des autres experts métier, et je sollicite des revues techniques ciblées : voir [collecte de l'information](https://docs.redaction-technique.org/fr/tech-writing-process/gathering-information/) et la [check-list de revue technique](https://docs.redaction-technique.org/fr/toolkit/technical-review-checklist/).
- Les modifications de la documentation passent par des branches et une revue par pull request, en séparant revue technique et revue éditoriale : voir le [workflow de revue documentaire](https://docs.redaction-technique.org/fr/toolkit/example-review-workflow/).

### Libérez vos informations de leurs silos

Des solutions souples et fiables libèrent vos informations des silos d'information cloisonnés où elles sont emprisonnées et sous-exploitées. Oubliez **MS Word** ou **FrameMaker** pour passer de la maintenance de la documentation à la gestion du cycle de vie des projets documentaires modulaires !

[Intégrer la documentation aux processus de développement](https://docs.redaction-technique.org/fr/tech-writing-process/integrating-documentation-into-development/) détaille ce que cela suppose : une documentation qui sort en même temps que le produit, suit les mêmes cycles de vie et le même contrôle qualité, sans *vendor lock-in*, avec des chaînes de publication libres et gratuites et une mise en page totalement automatisée.

### Domaines d'expertise

La page [Expertise](https://docs.redaction-technique.org/fr/expertise/) relie chaque domaine aux articles qui en témoignent :

- [Docs-as-code](https://docs.redaction-technique.org/fr/expertise/#docs-as-code)
- [DITA et rédaction structurée](https://docs.redaction-technique.org/fr/expertise/#dita-et-rédaction-structurée)
- [Architecture documentaire](https://docs.redaction-technique.org/fr/expertise/#architecture-documentaire)
- [Documentation développeur et d'API](https://docs.redaction-technique.org/fr/expertise/#documentation-développeur-et-dapi)
- [Automatisation et CI/CD](https://docs.redaction-technique.org/fr/expertise/#automatisation-et-cicd)
- [Documentation assistée par l'IA](https://docs.redaction-technique.org/fr/expertise/#documentation-assistée-par-lia)
- [Processus documentaire et qualité](https://docs.redaction-technique.org/fr/expertise/#processus-documentaire-et-qualité)
- [Documentation multilingue](https://docs.redaction-technique.org/fr/expertise/#documentation-multilingue)

### Disponibilité

Mon contrat actuel de rédacteur technique senior chez Unity se termine le 1er octobre 2026. Je suis ouvert à de nouvelles opportunités à partir d’octobre 2026.

### Me contacter

- **LinkedIn :** [linkedin.com/in/carrereolivier](https://www.linkedin.com/in/carrereolivier/). Le meilleur moyen de me contacter au sujet d'un poste ou d'un projet de rédaction technique.
- **Code source de ce site :** [github.com/olivier-carrere/redaction-technique.org](https://github.com/olivier-carrere/redaction-technique.org/)
- **Profil professionnel, travaux choisis et articles :** [redaction-technique.org](https://redaction-technique.org/) (en anglais)

## Comment ce site est construit

Cette partie est le colophon du site. L'[historique du site](https://docs.redaction-technique.org/fr/site-history/) retrace le passage de ce corpus documentaire de WordPress à Sphinx puis à Astro, et le devenir de chaque page en chemin.

Ce site traite des processus et des formats de rédaction technique : son [historique et ses branches Git](https://github.com/olivier-carrere/redaction-technique.org/) sont donc aussi pertinents que son contenu.

Il traite des formats, des outils et des tâches suivants : **reStructuredText**, **DITA XML**, scripts Bash, awk, sed, expressions rationnelles, Python, gestion de versions, Git, compilation, Makefile, Ant, XSLT, mise en page, HTML, CSS, PDF, LaTeX, XSL-FO.

Aujourd'hui, le site est rédigé en MDX et compilé avec Astro et Starlight. GitHub Actions le compile à chaque push et pull request, une suite de tests vérifie son contenu et son API, et il est publié en français et en anglais. Les mêmes sources alimentent aussi une [API lisible par les machines](https://docs.redaction-technique.org/fr/about-the-api/) et un [assistant documentaire](https://docs.redaction-technique.org/fr/ask/) fondé sur ce contenu.

> **Schéma: La pile technique sur laquelle ce site est construit aujourd’hui**
>
> Pile en couches des technologies que ce site documentaire utilise actuellement, de bas en haut : Git et GitHub pour la gestion de versions ; MDX et TypeScript pour le contenu et le code ; Astro 7 avec Starlight comme framework du site ; les variables CSS pour la mise en forme ; les tests Node.js et GitHub Actions pour les contrôles à chaque push ; Vercel pour la compilation et l’hébergement ; et HTML, Markdown et llms.txt comme formats publiés.

*La pile technique sur laquelle ce site est construit aujourd’hui*

### Les sources de ce site sont gérées sous Git

Ce site a été initialement développé sous WordPress. L'impossibilité d'effectuer sous ce CMS (Content Management System) des modifications transverses ou d'avoir un suivi précis du cycle de vie du contenu a entraîné une migration vers le format de balisage léger **reStructuredText**.

> **Schéma: Plateformes de gestion du cycle de vie de la documentation**
>
> Deux plateformes documentaires présentées comme des piles parallèles des mêmes sept couches, chaque ligne associant un outil open-source à son équivalent partiellement open-source. Du système d’exploitation vers le haut : Linux et Windows ; Git avec Bugzilla et Componize/DocZone ; reStructuredText et DITA XML ; Python Sphinx et le DITA Open Toolkit ; Make, Bash et sed face à Ant ; CSS, LaTeX, Inkscape et Emacs face à CSS, XSLT, XSL-FO, Illustrator et XMetaL ; et, en sortie, PDF, HTML et ePUB face à PDF et HTML.

*Plateformes de gestion du cycle de vie de la documentation*

Toutes les versions de ce site sont gérées sous le logiciel de gestion de versions décentralisé Git. Les modifications de contenu, de structure ou de mise en page peuvent désormais être :

- regroupées par lots cohérents,
- liées à un ticket de logiciel de suivi de problèmes tel que *Bugzilla* ou *Jira*,
- validées par des pairs,
- partagées entre différentes versions du projet de documentation,
- annulées en une seule opération, etc.

### Formats sources

La version 1.1 de ce site était disponible en trois formats sources, de niveaux de fonctionnalités et de complexité différents.

> **Schéma: Fonctionnalités et complexité des formats texte**
>
> Diagramme en quadrants positionnant reStructuredText, DocBook et DITA XML selon leur complexité et leurs fonctionnalités. reStructuredText est faible sur les deux axes. DocBook est plus complexe mais reste limité en fonctionnalités. DITA XML est à la fois complexe et riche en fonctionnalités.

*Niveau de fonctionnalités et de complexité des formats texte*

reStructuredText

: reStructuredText est un langage de balisage léger de type Wiki ou Markdown qui, combiné au générateur de documentation Sphinx, offre un bon niveau de fonctionnalités.

DITA XML

: DITA XML est une architecture documentaire XML sémantique et modulaire complexe qui offre des gains de productivité importants grâce à une forte réutilisation du contenu.

DocBook

: DocBook est un langage de balisage XML sémantique qui offre un rapport fonctionnalités/complexité aujourd'hui peu intéressant.

### Formats cibles

La version Sphinx était compilée aux formats :

- PDF,
- EPUB,
- HTML.

Ces différentes versions étaient générées à partir des mêmes sources exactement. Elles présentaient cependant de légères variations, mises en œuvre par un mécanisme de texte conditionnel. Par exemple, le terme suivant varie selon le format cible :

| Format cible | Terme             |
|--------------|-------------------|
| PDF          | document          |
| EPUB         | livre électronique |
| HTML         | site              |

---

Source: https://docs.redaction-technique.org/fr/about-this-blog/