Aller au contenu
Olivier CarrèrePratique de la rédaction technique

Historique du site

Cet historique commence avec l’enregistrement de redaction-technique.org en février 2012 et suit les systèmes de publication, les évolutions du contenu et les choix d’architecture documentés qui ont mené au portfolio de documentation actuel.

Les grandes étapes résument l’histoire. La frise en donne le détail, à partir du dépôt Git et du contenu lui-même ; chaque affirmation indique d’où elle provient, et ce que le dépôt ne permet pas d’établir est signalé comme tel.

Période couverte
février 2012 – aujourd’hui
Enregistré dans Git
octobre 2014 – aujourd’hui
Systèmes de publication
3, et 3 expérimentations
Phases de contenu
10
Versions
7
Modifications répertoriées
48

Grandes étapes

L’histoire en bref. Chaque étape renvoie à son entrée détaillée dans la frise. Ces notes replacent l’histoire du site dans l’évolution plus large de la rédaction et de la documentation technique.

  1. 2012

    1. Origine

      Domaine enregistréredaction-technique.org

    Asciidoctor voit le jour

    Implémentation d’AsciiDoc en Ruby, Asciidoctor naît d’un prototype écrit pour le site de Git et publie sa première version en juin. Il contribue à faire de simples fichiers texte la source d’une chaîne documentaire programmable.

    Sources : Asciidoctor historyAsciidoctor documentationAsciidoctor releases on RubyGems

  2. 2013

    1. Système de publication

      Blog WordPress

    Le docs-as-code prend forme

    La première conférence Write the Docs, à Portland en avril, marque l’émergence d’une communauté consacrée à la documentation. À la même période prennent forme les pratiques aujourd’hui appelées docs-as-code : Git, balisage en texte brut, relecture de code et vérifications automatisées appliqués à la documentation.

    Sources : Write the Docs conferencesWrite the Docs origin storyWrite the Docs: Docs as Code

  3. 2014

    1. Système de publication

      Site reStructuredText / Sphinx

    2. Expérimentation

      Version DITA XML

    3. Expérimentation

      Version DocBook, issue de la branche DITA

    La documentation structurée mûrit

    Norme OASIS depuis 2005, DITA offre à la documentation professionnelle un modèle de contenu structuré et réutilisable. DITA Open Toolkit 2.0 paraît en novembre, un mois après que HTML5 est devenu une recommandation du W3C : le Web s’affirme comme support de diffusion du contenu technique.

    Sources : OASIS DITA Technical CommitteeDITA Open Toolkit releasesW3C HTML5 Recommendation

  4. 2021

    1. Événement

      Dernier état Sphinx

    Le docs-as-code s’impose

    En 2021, le docs-as-code est une pratique établie de la documentation logicielle. Les rédacteurs techniques travaillent de plus en plus dans des dépôts Git, avec relecture par pull request, vérifications automatisées et générateurs de sites statiques, et publient la documentation comme on livre un logiciel.

    Sources : Write the Docs: Docs as CodeAnne Gentle: Docs Like CodeGitLab documentation workflow

  5. 2025

    1. Expérimentation

      Première tentative Astro, sur une branche parallèle

    2. Système de publication

      Site de documentation Astro / Starlightv2.0.0

    3. Événement

      La documentation passe sur docs.redaction-technique.org

    La documentation assistée par l’IA s’accélère

    Dans le travail documentaire, l’IA passe peu à peu de l’expérimentation à la pratique, de plus en plus pour rédiger, résumer, rechercher et relire. La documentation se publie aussi à l’intention des agents d’IA, au moyen de fichiers llms.txt et de serveurs Model Context Protocol, comme celui de Microsoft Learn lancé en juin 2025.

    Sources : Write the Docs Portland 2025 talksStack Overflow 2025 survey: AIThe llms.txt proposalMicrosoft Learn MCP Server

  6. 2026

    1. Version

      Architecture de l’information et plateforme documentairev2.1.0

    2. Version

      Repositionnement en portfolio de rédaction techniquev2.2.0

    Documentation et ingénierie logicielle convergent

    La documentation recoupe de plus en plus l’ingénierie logicielle : conservée dans les dépôts, vérifiée en intégration continue, elle s’écrit pour les agents de codage autant que pour les personnes, à l’image des fichiers AGENTS.md. Des conférences de Write the Docs 2026 examinent les rapports entre documentation et grands modèles de langage.

    Sources : AGENTS.mdLinux Foundation: Agentic AI FoundationWrite the Docs Portland 2026 talks

  7. Aujourd’hui

    1. État actuel

Comment le site a évolué

Du plus ancien au plus récent. Les lignes suivent l’ordre des événements et non une échelle de temps : une longue période sans activité occupe une seule ligne.

Comment lire cet historique

Chaque système de publication s’ouvre par un titre, et chaque année par son millésime. Les événements sont à gauche ; ce qui a changé dans le contenu est à droite, ou en dessous sur petit écran.

  • Losange : l’origine de l’historique, l’enregistrement du domaine. Il ne figure pas dans Git.
  • Ligne de production : l’historique à partir duquel le site est publié.
  • Gros point plein : un système de publication commence sur la ligne de production.
  • Absent de Git : connu seulement par des indices indirects.
  • Aucune activité Git enregistrée sur la ligne de production. Cela ne signifie pas que le site était hors ligne.
  • Branche parallèle : une expérimentation jamais fusionnée.
  • Version : une version étiquetée de l’ensemble du site.
  • Se poursuit aujourd’hui.

Les références de commit, les preuves et les incertitudes s’ouvrent depuis le volet de chaque entrée, au clic, au toucher ou au clavier. Origine de chaque affirmation : observée dans Git ou dans le contenu, rapportée par l’auteur, déduite, ou non établie.

Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Comparaison de contenu. Mesuré en comparant le texte des pages d’une version à l’autre.Propos de l’auteur. Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.Interprétation. Une lecture des indices, et non une observation directe.Incertain. Non établi par les indices.

  1. Origine

    Domaine enregistré

    redaction-technique.org

    Rien n’est documenté entre l’enregistrement et le plus ancien indice du blog WordPress, en février 2013.

    Origine de l’information : Propos de l’auteur. Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.
    Preuves et incertitudes

    Détail en anglais, tel qu’enregistré.

    • Domain registration, recorded by hand by the site's author. It predates the repository: there is no commit for it. (Propos de l’auteur)

    Non établi

    • What the domain served between the registration and the earliest trace of the WordPress blog, in February 2013.
    • The licence added to the imported files claims copyright from 2011, a year before the registration. The repository does not explain the difference.

  2. Système de publication 1 sur 3≤ 2013?

    WordPress

  3. ≤ 2013?

    Blog WordPress

    • Absent de Git
    • Contexte historique

    Le site d’origine. Ses sources ne figurent pas dans le dépôt : il en reste le contenu importé le 21 octobre 2014, en français, sous la forme d’un fichier reStructuredText unique de 106 sections.

    Activité Git
    aucune : absent de Git
    En production
    dates non documentées; encore en ligne le 28 octobre 2014
    Origine de l’information : Propos de l’auteur. Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Incertain. Non établi par les indices.
    Preuves et incertitudes

    Le travail sous Sphinx commence dans Git le 21 octobre 2014 alors que WordPress est encore le site en ligne le 28 octobre 2014 : les deux se chevauchent. La date à laquelle la version Sphinx a remplacé WordPress n’est pas documentée.

    Détail en anglais, tel qu’enregistré.

    • "Add content from current www.redaction-technique.org website": a single 5,832-line redaction-technique-org.rst. (Git)
    • A WordPress media-library path in the imported text: the media library contains a file uploaded in February 2013. (Git)
    • Tag note, written 2014-10-28: "Still some glitches, but already better than current WordPress version." WordPress was still the live site then. (Propos de l’auteur)
    • The site states it "a été initialement développé sous WordPress" and that the CMS's lack of cross-cutting changes and lifecycle tracking led to the move to reStructuredText. (Propos de l’auteur)
    • The licence header added to every imported file claims copyright from 2011 ("Copyright 2011-2014"). (Propos de l’auteur)
    • The pruning commit removed "formerly unpublished sections", which suggests the import included unpublished material. (Propos de l’auteur, Interprétation)

    Non établi

    • Start date. The licence claims copyright from 2011 and the oldest upload dates from February 2013. Neither proves when the WordPress site opened.
    • End date. WordPress was still live on 2014-10-28. When the Sphinx build replaced it is not recorded.
    • Post dates, categories, tags, authors and URLs did not survive: the import is ordered alphabetically by title and carries no per-article metadata.
    • Whether the "documentation-code-source-" filename prefix reproduces WordPress slugs or was added during the import.

    Contenu≤ 2013? – octobre 2014

    Un blog francophone sur la documentation gérée comme du code source

    L’import contient 106 sections : la rédaction technique comme processus industriel, les formats structurés et DITA XML, les conref et le texte conditionnel, la migration de FrameMaker vers DITA, la gestion de versions et le travail de groupe, des didacticiels DITA Open Toolkit et XSL-FO, ainsi que des supports marketing (livre blanc, plaquette, magazine d’entreprise, site web).

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Interprétation. Une lecture des indices, et non une observation directe.
    1 modification dans cette phase

    Détail en anglais, tel qu’enregistré.

    1. Import

      All content imported into one reStructuredText file, ordered alphabetically by title.

      commit 1fc63738Git

  4. Système de publication 2 sur 32014–2021

    reStructuredText / Sphinx

  5. 2014

  6. Site reStructuredText / Sphinx
    • Ligne de production

    Le contenu importé, reconstruit en projet Sphinx à source unique publiant du HTML, du PDF et de l’EPUB, et à partir de 2015 une édition imprimée. Versions 0.1 à 1.5 en 2014-2015, puis enrichi sous forme de blog ; la dernière modification Sphinx date du 17 juillet 2021.

    Activité Git
    octobre 2014 – juillet 2021
    En production
    dates non documentées
    Hébergement
    aucun enregistrement dans Git ; indices d’une compilation sur Read the Docs (2014) et d’une page Sphinx en ligne (2025)
    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Propos de l’auteur. Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.Incertain. Non établi par les indices.
    Preuves et incertitudes

    Ni la date de mise en ligne de la version Sphinx ni celle de son remplacement ne sont documentées. Le dépôt contient des indices d’une compilation sur Read the Docs en décembre 2014 et, en mai 2025, un lien vers une page en ligne du site Sphinx, mais aucun enregistrement indépendant de l’hébergement. Le dernier commit Sphinx date du 17 juillet 2021 et la conversion vers Astro du 13 septembre 2025.

    Détail en anglais, tel qu’enregistré.

    • Split the imported file into one .rst file per section (106 files). (Git)
    • Tag note: "All text and code reviewed". (Propos de l’auteur)
    • PDF cover for the lulu.com print version. (Git)
    • Applied sphinx_rtd_theme. (Git)
    • The welcome page offers "une version compilée sur Read the Docs", linked to readthedocs.org/projects/redaction-techniqueorg. (Git, Propos de l’auteur)
    • The link is removed. Commit message: "Inline conditional text processing implemented in Makefile is not supported on Read the docs." (Propos de l’auteur)
    • Last reStructuredText commit. Tag note: "Latest Python Sphinx version". (Git)
    • The reStructuredText-Sphinx branch ends at this commit, which is also part of master's history: the branch marks the last Sphinx state rather than a separate line of work. (Git)
    • On the patch-1 side branch, the first Astro attempt's French About page links to the "version HTML" of the earlier content at redaction-technique.org/diminuer-les-couts-ameliorer-la-satisfaction-client.html, a page of the Sphinx site. A link is not a hosting record. (Git, Propos de l’auteur)

    Non établi

    • Hosting. The welcome page linked to a compiled version on Read the Docs from 2014-12-19 to 2014-12-29, and a May 2025 link points to a live page of the Sphinx site, but Git holds no hosting record. The dates the Sphinx build went live and was replaced are not recorded.
    • How long the site was served from the Sphinx build after 2021-07-17. The May 2025 link suggests a Sphinx page was still online then. It does not show until when.

    Contenu

    Élagué et restructuré en manuel en trois parties

    Le blog importé devient un manuel en trois parties : diminuer les coûts et améliorer la satisfaction client, la rédaction technique comme processus industriel, et le format structuré DITA XML. Le nettoyage d’octobre-novembre 2014 écarte 38 sections importées, dont les pages de supports marketing et des quasi-doublons. Les fichiers portent des commentaires de statut de relecture du texte et du code, toujours présents dans 86 fichiers du dernier état Sphinx ; la version 1.0 marque l’ensemble du texte et du code comme relus.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Propos de l’auteur. Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.Interprétation. Une lecture des indices, et non une observation directe.
    5 modifications dans cette phase

    Détail en anglais, tel qu’enregistré.

    1. Restructuration

      Split into one file per section.

      commit 59f6bbd1Git

    2. Contenu supprimé

      36 sections deleted. The commit calls them unpublished or no longer in line with the new site.

      commit e6ad350cGit, Propos de l’auteur

    3. Contenu supprimé

      Deleted "Faciliter le travail de groupe avec Subversion, cron et Emacs".

      commit 7fa3d89dGit

    4. Contenu supprimé

      Deleted "Tests de non-régression".

      commit bda8e681Git

    5. Relecture

      Release 1.0: all text and code marked as reviewed (69 .rst files).

      commit ca619c6bGit, Propos de l’auteur

  7. Version

    0.1 : code source étiqueté sur GitHubPremière version du site Sphinx
    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.

  8. WordPress encore en ligne

    • Absent de Git

    La note de l’étiquette 0.1 qualifie WordPress de version « actuelle ».

    Origine de l’information : Propos de l’auteur. Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.

  9. Version

    1.0 : code source étiqueté sur GitHubTexte et code entièrement relus
    Origine de l’information : Propos de l’auteur. Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.

  10. Version

    1.1 : code source étiqueté sur GitHubPoint de départ de la branche DITA
    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.

    Version DITA XML
    • Expérimentation
    • Branche parallèle

    La branche DITA XML part de la version 1.1.

    Une conversion parallèle de la version reStructuredText 1.1 vers DITA XML, configurée pour produire un PDF avec DITA Open Toolkit. La ligne Sphinx a continué indépendamment à partir de la même version, et la branche DITA n’a jamais été fusionnée. Une branche DocBook en est partie le 30 novembre 2014 et n’a pas été poursuivie après le 9 décembre 2014.

    Activité Git
    novembre – décembre 2014
    Publication
    inconnue
    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Comparaison de contenu. Mesuré en comparant le texte des pages d’une version à l’autre.Incertain. Non établi par les indices.
    Preuves et incertitudes

    On ne sait pas si la version DITA a jamais été publiée en ligne ; son README décrit uniquement une génération PDF locale.

    Détail en anglais, tel qu’enregistré.

    • Both the DITA branch and the continuing Sphinx line start from release 1.1. (Git)
    • README: "DITA XML version based on reST version 1.1". It describes building full.ditamap into a PDF with DITA-OT 1.8.5. (Git, Propos de l’auteur)
    • "Migrate to DITA XML": 50 topics with no code, plus no-code-topics.ditamap. (Git)
    • Removed the reStructuredText files on the DITA branch only. The Sphinx line kept them. (Git)
    • Hierarchical full.ditamap. Tasks added 2014-11-18 to 2014-11-20. (Git)
    • The only DITA release tag. (Git)
    • A DocBook branch starts from dita-0.1 ("Add DocBook version"). 7f55e388 then removes the DITA files from it. (Git)
    • Last commit on the DITA branch. (Git)

    Non établi

    • Whether the DITA version was ever published online. The README only describes a local PDF build.
    • Editorial passes made on the branch (bold to italics, non-breaking spaces) also appear on the Sphinx line in December 2014 (67ba3281, 4cda9d57). Which one influenced the other cannot be proven.

    Contenu

    Le même contenu, converti en DITA XML

    Une branche parallèle issue de la version 1.1, menée en marge de la ligne Sphinx. Elle convertit le contenu sans l’enrichir : en valeur médiane, 89 % du texte de chaque topic DITA se retrouve dans le fichier .rst correspondant de la version 1.1. Les sections sont typées en topics et en tâches et assemblées par des ditamaps ; aucun nouvel article n’est rédigé.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Comparaison de contenu. Mesuré en comparant le texte des pages d’une version à l’autre.
    2 modifications dans cette phase

    Détail en anglais, tel qu’enregistré.

    1. Conversion de format

      Topics without code converted to DITA.

      commit ad6c24edGit

    2. Conversion de format

      Remaining topics added.

      commit db5a521bGit

    Contenu

    Conventions éditoriales et publication multiformat

    Dans la continuité de la version 1.1, dont part aussi la branche DITA : la terminologie passe dans des substitutions, les liens externes sont centralisés, la typographie est normalisée, la page d’accueil est réécrite et les illustrations sont régénérées à partir de sources SVG pour le HTML, le PDF, l’EPUB et l’impression. Versions 1.1 à 1.5.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.
    3 modifications dans cette phase

    Détail en anglais, tel qu’enregistré.

    1. Révision

      Welcome page rewritten and restructured.

      commit aff876afGit

    2. Contenu ajouté

      Print edition for lulu.com.

      commit f77e40e6Git

    3. Restructuration

      PNG and PDF images generated from SVG sources.

      commit 1d621175Git

  11. La branche DocBook part de dita-0.1

    • Expérimentation
    Activité Git
    novembre – décembre 2014
    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.

  12. Les branches DITA et DocBook s’arrêtent

    Aucune n’a été fusionnée dans la ligne de production ; le site Sphinx a continué.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.

  13. 2015

  14. Version

    1.5 : code source étiqueté sur GitHubDernière version numérotée sous Sphinx
    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.

  15. 291 jours

    Aucune activité Git enregistrée sur la ligne de production. Cela ne signifie pas que le site était hors ligne.

  16. 2016

  17. Contenu

    Du manuel au blog : didacticiels et projet de bout en bout

    Les premiers nouveaux articles et sections depuis l’import : une section « Le coin du geek » (Python, Raspberry Pi), des didacticiels sur le texte conditionnel et l’insertion de données avec Jinja, SQL, Excel et DITA, et une étude de cas « Mener un projet de bout en bout » découpée en 14 pages, puis 15. Le site se présente comme un blog à partir de 2016.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Propos de l’auteur. Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.
    9 modifications dans cette phase

    Détail en anglais, tel qu’enregistré.

    1. Contenu ajouté

      String manipulation with Python.

      commit 7951e910Git

    2. Contenu ajouté

      Raspberry Pi as a documentation platform.

      commit 69c5b05eGit

    3. Contenu ajouté

      New top-level section "Le coin du geek".

      commit 583f22a6Git

    4. Renommage

      Dropped the "documentation-code-source-" prefix from every file name.

      commit 7a867bc3Git

    5. Contenu ajouté

      Start of the 2018 conditional-text and data-insertion tutorials.

      commit 68fb0652Git

    6. Fonction ajoutée au site

      Homepage box listing recent Git changes. An early form of today's change history.

      commit 92adcbf3Git, Interprétation

    7. Contenu ajouté

      New section "Mener un projet de bout en bout".

      commit 951d843cGit

    8. Restructuration

      The project section split into 14 pages.

      commit 69afa81eGit

    9. Contenu ajouté

      A 15th project page, on Git.

      commit 16e63892Git

  18. 382 jours

    Aucune activité Git enregistrée sur la ligne de production. Cela ne signifie pas que le site était hors ligne.

  19. 2017

  20. Reprise de l’activité Git sur la ligne de production

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.

  21. 272 jours

    Aucune activité Git enregistrée sur la ligne de production. Cela ne signifie pas que le site était hors ligne.

  22. 2018

  23. Reprise de l’activité Git sur la ligne de production

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.

  24. 913 jours

    Aucune activité Git enregistrée sur la ligne de production. Cela ne signifie pas que le site était hors ligne.

  25. 2021

  26. Contenu

    Derniers articles Sphinx

    Des articles d’accueil sur la documentation en microservices et sur les personas. Aucun n’a été repris dans Astro. Le site Sphinx s’achève avec 110 pages.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Comparaison de contenu. Mesuré en comparant le texte des pages d’une version à l’autre.
    2 modifications dans cette phase

    Détail en anglais, tel qu’enregistré.

    1. Contenu ajouté

      Documentation/microservices comparison.

      commit fa5c0a5eGit

    2. Contenu ajouté

      Persona article on the homepage.

      commit 68956980Git

  27. Dernier état Sphinx

    L’historique Sphinx constitue la première partie de master. La branche reStructuredText-Sphinx ne fait que marquer son dernier état : ce n’est pas un produit distinct.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.

  28. 1519 jours

    Aucune activité Git enregistrée sur la ligne de production. Cela ne signifie pas que le site était hors ligne.

    Hors de la ligne de production : patch-1 (mai – juillet 2025). Une branche non fusionnée, partie du dernier commit Sphinx. Elle contient la première tentative Astro, présentée ci-dessous ; ses commits ultérieurs, à partir de juin 2025, ajoutent un contenu sans rapport. Aucun n’a rejoint master.

  29. 2025

  30. Première tentative Astro, sur une branche parallèle

    • Expérimentation
    • Branche parallèle

    Les travaux sur Astro et Starlight commencent en mai 2025 sur une branche parallèle, patch-1, à l’écart de la ligne de production. Pandoc convertit en Markdown 109 des 110 pages Sphinx. Deux jours plus tard, un petit site bilingue est plutôt lancé à partir de zéro, puis les pages converties et les sources Sphinx sont retirées de la branche. Cette version n’a pas rejoint la ligne de production : en septembre 2025, la conversion est refaite à partir du dernier état Sphinx, et c’est elle qui devient le site actuel.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Propos de l’auteur. Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.Interprétation. Une lecture des indices, et non une observation directe.
    Preuves et incertitudes

    Détail en anglais, tel qu’enregistré.

    • "Convert ReStructuredText to Markdown", the branch's first commit: 109 Markdown files, one for each page of the last Sphinx state except "documentation microservices.rst". (Git)
    • "Rebuild blog from scratch". (Git)
    • The attempt's page "Migrate content from Python Sphinx to Astro": "I used Pandoc to convert it to Markdown automatically", then "I just decided to git rm everything and start fresh", as the content "didn't reflect state-of-the-art technical writing practices". (Propos de l’auteur)
    • Merge of pull request #1. This merge commit is on patch-1 only. Master does not contain it. (Git)
    • "Remove Sphinx content": the converted Markdown files and the .rst sources leave the branch. (Git)

    Non établi

    • When the attempt was set aside.
    • Whether this version was ever published online.
    • Pull request #1 was merged on GitHub on 2025-05-11, but its merge commit is not on master. Whether it targeted another branch, or master was later reset, is not recorded.

  31. Système de publication 3 sur 32025–aujourd’hui

    Astro / Starlight

  32. 2025

  33. La conversion en Markdown commence

    Le dernier état Sphinx est de nouveau converti en Markdown à partir d’un premier commit, et c’est cette conversion qui devient le site en production. Elle se poursuit les jours suivants.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Propos de l’auteur. Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.Comparaison de contenu. Mesuré en comparant le texte des pages d’une version à l’autre.Incertain. Non établi par les indices.
    Preuves et incertitudes

    Le site Astro prolonge la ligne de production Sphinx sur master. Il a été converti à partir du dernier état Sphinx, et non de la branche DITA.

    Git conserve des indices d’une partie des outils de conversion, mais pas un enregistrement reproductible de chaque étape. La page de la tentative de mai 2025 indique que pandoc a converti les pages ; 98 des 109 fichiers Markdown produits en premier en septembre correspondent à ce résultat une fois les retours à la ligne ignorés ; et une branche non fusionnée conserve les scripts de traitement ultérieurs.

    Détail en anglais, tel qu’enregistré.

    • The May 2025 attempt's own page: "I used Pandoc to convert it to Markdown automatically". (Propos de l’auteur)
    • "Update markdown files" on the unmerged starlight branch: 109 Markdown files, one per Sphinx page, before any Starlight processing. (Git)
    • convert2starlight.py, on the same branch: asks an OpenAI model to turn each Markdown file into a Starlight page. (Git)
    • "Create dir structure from Sphinx TOC", after toc.js and create_docs.sh were added. (Git)

    Non établi

    • Every conversion step: the commands run between these commits, and any edits made by hand, are not recorded.

    Contenu

    Converti en Markdown et consolidé

    Les 110 pages du site Sphinx deviennent 63 fichiers Markdown français répartis en cinq sections, 49 après la suppression des pages en double le 15 septembre 2025. Le texte de nombreuses sous-pages Sphinx se retrouve dans leur page parente plutôt que dans des pages distinctes : voir les pages « fusionnées dans une autre page » de la filiation. Une version anglaise est rédigée avec l’IA et ses illustrations traduites.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Comparaison de contenu. Mesuré en comparant le texte des pages d’une version à l’autre.Propos de l’auteur. Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.
    6 modifications dans cette phase

    Détail en anglais, tel qu’enregistré.

    1. Conversion de format

      Conversion from reStructuredText to Markdown begins.

      v2.0.0commit 67b3e056Git

    2. Contenu supprimé

      Deleted 15 end-to-end project pages as duplicates: their text was already in the project's main page.

      v2.1.0commit 222a4c57Git, Propos de l’auteur, Comparaison de contenu

    3. Traduction

      First draft English version.

      v2.1.0commit 291fd568Git

    4. Contenu supprimé

      Deleted the standalone formats-cibles page: its text was already on the About page.

      v2.1.0commit 2237502aGit, Comparaison de contenu

    5. Traduction

      AI-generated English version (pull request #3).

      v2.1.0commit 907ade6bGit, Propos de l’auteur

    6. Traduction

      Images translated.

      v2.1.0commit aa3b1e09Git

  34. Version

    v2.0.0 : code source étiqueté sur GitHubMigration vers Astro + Starlight
    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.

  35. La documentation passe sur docs.redaction-technique.org

    À partir du 16 septembre 2025, la documentation renvoie vers sa propre adresse, docs.redaction-technique.org, et oriente les lecteurs vers un blog à l’adresse www.redaction-technique.org. Ce blog est un projet distinct : son historique commence le même jour et ne partage aucun commit avec celui-ci.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Interprétation. Une lecture des indices, et non une observation directe.
    Preuves et incertitudes

    Détail en anglais, tel qu’enregistré.

    • "change link to docs.redaction-technique.org": the homepage links point to docs.redaction-technique.org instead of redaction-technique.org. (Git)
    • The homepages link to a "Blog" at https://www.redaction-technique.org/, "A blog about all things documentation as code." (Git, Propos de l’auteur)
    • The blog's "Initial commit", on branches main and draft of the same repository: a history with no commit in common with master. Later that day it redirects its own links to docs.redaction-technique.org (b48b765c). (Git)
    • The documentation's configuration sets its address to https://docs.redaction-technique.org/. (Git)
    • The blog's configuration sets its address to https://redaction-technique.org. (Git)

    Non établi

    • When each address began serving each site: DNS and hosting changes are not in Git.

  36. 254 jours

    Aucune activité Git enregistrée sur la ligne de production. Cela ne signifie pas que le site était hors ligne.

  37. 2026

  38. Contenu

    Slugs anglais, métadonnées de recherche et finitions éditoriales

    Les pages des deux langues reçoivent des slugs anglais avec redirections, les métadonnées de recherche sont améliorées, « Technology watch » devient « Tutorials », des relectures dans les deux langues suivent le nouveau guide de style, et plusieurs didacticiels sont modernisés avec des démonstrations interactives dans le navigateur.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.
    7 modifications dans cette phase

    Détail en anglais, tel qu’enregistré.

    1. Restructuration

      Search metadata improved across all English and French pages.

      v2.1.0commit 447b8ae8Git

    2. Renommage

      English slugs translated from French, with 301 redirects.

      v2.1.0commit a6e00789Git

    3. Contenu ajouté

      Writing style guide.

      v2.1.0commit 3d49d457Git

    4. Renommage

      French slugs aligned with English ones.

      v2.1.0commit 8ae964dbGit

    5. Renommage

      "Technology watch" section renamed "Tutorials".

      v2.1.0commit 5c58c6b0Git

    6. Révision

      DITA XML/XSL-FO tutorials modernised for DITA-OT 4.4.

      v2.1.0commit 4775bf8bGit

    7. Contenu supprimé

      Word-shuffling Python page deleted.

      v2.1.0commit 16b7d6e0Git

  39. Contenu

    Architecture de l’information par objectifs et plateforme documentaire

    La navigation est réorganisée autour des objectifs du lecteur et chaque article reçoit une structure de concept, de tâche ou de référence ; le commit précise qu’aucun texte n’a été réécrit. Nouveau contenu : une boîte à outils pratique et un glossaire. Nouvelles fonctions du site : l’assistant « Interroger la documentation » et une API documentaire statique. Les schémas sont redessinés, d’abord en Mermaid, puis en SVG générés à la compilation.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Propos de l’auteur. Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.
    6 modifications dans cette phase

    Détail en anglais, tel qu’enregistré.

    1. Fonction ajoutée au site

      "Ask the documentation" assistant.

      v2.1.0commit 8de98035Git

    2. Fonction ajoutée au site

      Static documentation API (llms.txt, JSON index).

      v2.1.0commit e9d7b09aGit

    3. Restructuration

      Navigation by reader goal.

      v2.1.0commit 081b58beGit

    4. Restructuration

      Articles given a concept/task/reference structure. According to the commit, no prose was rewritten.

      v2.1.0commit bc644c60Git, Propos de l’auteur

    5. Contenu ajouté

      Toolkit, glossary and API documentation page.

      v2.1.0commit 2e4a841aGit

    6. Restructuration

      All diagrams as native SVG components.

      v2.2.0commit 7c647c39Git

  40. Version

    v2.1.0 : code source étiqueté sur GitHubArchitecture de l’information et plateforme documentaire
    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.

  41. Version

    v2.2.0 : code source étiqueté sur GitHubRepositionnement en portfolio de rédaction technique
    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.

    Contenu

    Audit de contenu et repositionnement en portfolio

    Un audit de contenu mené en 2026 modernise les pages de processus dans les deux langues, rédigées séparément pour chaque langue selon le commit. Le site est repositionné comme portfolio de rédacteur technique senior, et la navigation par thème, l’historique des pages et les principales versions sont ajoutés.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Propos de l’auteur. Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.
    7 modifications dans cette phase

    Détail en anglais, tel qu’enregistré.

    1. Révision

      English/French content audit: process pages modernised, legacy material given context.

      v2.2.0commit f45b0179Git

    2. Contenu supprimé

      Obsolete "index in a PDF" page deleted.

      v2.2.0commit e742ee1dGit

    3. Annulation

      The archiving of seven legacy pages (9512f38d) was reverted the same day. The pages remain.

      v2.2.0commit fc99cdc3Git

    4. Contenu ajouté

      Expertise page and portfolio homepage.

      v2.2.0commit 23c92671Git

    5. Fonction ajoutée au site

      Change history on documentation pages.

      Non publiéecommit ee0a661fGit

    6. Fonction ajoutée au site

      Browse the documentation by topic.

      Non publiéecommit d920814eGit

    7. Fonction ajoutée au site

      Git release milestones.

      Non publiéecommit 33d3b631Git

  42. Aujourd’hui

    Site de documentation Astro / Starlight
    • Ligne de production
    • En cours

    Le site actuel. Après une première tentative sur une branche parallèle en mai 2025, le dernier état Sphinx a été converti en Markdown en septembre 2025 à partir d’un premier commit ; la conversion s’est poursuivie dans les commits suivants, et master a continué à partir de là. Le site est devenu bilingue (français et anglais) en septembre 2025, a été restructuré selon les objectifs du lecteur en 2026 et repositionné comme portfolio de rédaction technique.

    3 modifications depuis v2.2.0 ne figurent encore dans aucune version.

    Activité Git
    septembre 2025 – en cours
    En production
    actuel ; début non documenté
    Premiers travaux Astro
    mai 2025, sur une branche parallèle
    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Propos de l’auteur. Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.Incertain. Non établi par les indices.
    Preuves et incertitudes

    Le site actuel, déployé sur Vercel. La date à laquelle il a remplacé le site Sphinx en production n’est pas documentée.

    Détail en anglais, tel qu’enregistré.

    • "Migrate to Àstro", made on the last Sphinx commit (68956980). Deletes 110 .rst files and adds a Starlight project (dimensional-disk/) holding the pages as Markdown, plus convert2starlight.py. (Git)
    • Merge of pull request #2. Release "Astro + Starlight migration". (Git)
    • Moved the Astro project to the repository root. (Git)
    • Vercel Analytics. (Git)
    • Release "Information architecture and documentation platform". (Git)
    • Release "Technical writing portfolio repositioning". (Git)

    Non établi

    • The complete conversion toolchain. Git records evidence of parts of it (see the conversion), not a reproducible record of every step.

État actuel

Ce à quoi l’historique ci-dessus a mené.

  • Construit avec Astro et Starlight à partir de sources Markdown et MDX conservées dans Git, et déployé sur Vercel.
  • 74 pages en français et 74 en anglais, organisées selon les objectifs du lecteur.
  • Dernière version : v2.2.0, le 19 septembre 2026.
  • Chaque envoi sur master est compilé par une vérification d’intégration continue, et une suite de tests automatisée contrôle le contenu, l’API documentaire et cet historique au regard de Git.
  • Chaque page de documentation affiche son historique de modifications issu de Git, et cette page est reconstituée à partir de Git par un script qui échoue à la moindre différence.
  • Les schémas sont des composants Astro réutilisables, dessinés en SVG lors de la compilation. Un assistant « Interroger la documentation » et une API documentaire statique (llms.txt, index JSON) sont produits à partir des mêmes sources.

Ce que nous apprend cet historique

Ce que la frise montre du contenu : ce que chaque changement de système de publication a conservé, ce qui a duré le plus longtemps et comment les schémas ont évolué.

Qu’est devenu le contenu ?

Chaque page est suivie par son texte, et non par son nom de fichier : une page est considérée comme reprise lorsqu’une part suffisante de son texte se retrouve dans une version ultérieure. Les trois étapes sont séparées de plusieurs années.

  1. Nettoyage de 2014

    Le contenu importé de WordPress, avant les premières versions du site Sphinx.

    106 sections importées de WordPress

    • 68conservées
    • 38écartée lors du nettoyage de 2014Importée de WordPress et supprimée lors du nettoyage d’octobre-novembre 2014, avant la version 1.0. N’a jamais atteint le site Sphinx ultérieur.

  2. Années Sphinx, 2014-2021

    Ce que contenait le site Sphinx dans son dernier état.

    110 pages dans le dernier état Sphinx

    • 68héritées de l’import WordPress
    • 42rédigées pendant les années Sphinx

  3. Conversion de 2025 et suite

    Ce que sont devenues ces 110 pages lors du passage à Markdown et Astro, et depuis.

    110 pages dans le dernier état Sphinx

    lors de la conversion de 2025
    • 39conservée comme page distincteA gardé une page distincte lors de la conversion de 2025 et en a toujours une.
    • 62fusionnée dans une autre pageN’a plus de page distincte après la conversion ; au moins 30 % de son texte se retrouve dans une autre page.
    • 6non repriseMoins de 30 % de son texte se retrouve dans le site converti ou actuel.
    après la conversion
    • 1conservée, puis réécriteA gardé une page distincte en 2025, mais la page actuelle conserve moins de la moitié du texte repris lors de la conversion.
    • 2reprise, puis suppriméeConvertie en 2025, puis supprimée.

    Hors de cette conversion : les 38 sections « écartée lors du nettoyage de 2014 » n’ont jamais atteint le site Sphinx.

    Lors de la conversion de 2025, la page médiane avait reçu sa dernière modification individuelle environ 9,3 ans plus tôt, et 34 des 110 pages avaient été modifiées individuellement pour la dernière fois en 2014. Les modifications appliquées à tout le site, comme la mise à jour de l’année du copyright, ne comptent pas comme des modifications individuelles. La conversion a donc en grande partie transporté une documentation ancienne, et non des textes récents.

    Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Interprétation. Une lecture des indices, et non une observation directe.

  4. Aujourd’hui

    74 pages en français

    • 43contiennent du texte du site historique
    • 31ne contiennent pas de texte du site Sphinx

    74 pages en anglais

    67 des 68 sections importées conservées en 2014 figurent toujours dans le site actuel, dans une page distincte ou au sein d’une autre page.

Ce qui a survécu

La version 1.0, en novembre 2014, organise le site en trois parties. Leurs introductions ouvrent toujours trois sections aujourd’hui :

Les sujets ont duré, pas la forme : ces pages ont été converties, restructurées et révisées. Autour d’elles, les didacticiels autrefois réunis dans « Le coin du geek » se trouvent désormais sous Didacticiels, l’étude de cas de bout en bout tient dans une seule page, et les schémas, les adresses des pages, la navigation et la page d’accueil ont tous été refaits.

Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.Comparaison de contenu. Mesuré en comparant le texte des pages d’une version à l’autre.Interprétation. Une lecture des indices, et non une observation directe.

Quatre générations de schémas

Les schémas ont connu quatre technologies :

  1. Des dessins SVG, sources des illustrations du site Sphinx.
  2. Les mêmes fichiers SVG repris dans le site Astro, avec des copies traduites pour les pages anglaises à partir du 21 septembre 2025.
  3. Des schémas Mermaid : essayés le 10 juin 2026 et annulés le jour même, puis adoptés à partir du 3 septembre 2026.
  4. Des composants Astro natifs qui dessinent chaque schéma en SVG lors de la compilation du site.

Tous les schémas ne sont pas passés par chaque étape : certaines pages utilisent encore des fichiers SVG.

Origine de l’information : Git. Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.

Comment l’historique a été reconstitué

Chaque affirmation de cette page porte un ou plusieurs de ces marqueurs. Sélectionnez un marqueur pour lire sa signification.

Catégories de preuves

GitObservé
Observé dans Git : un commit, sa date, une étiquette, une branche, un fichier ou son contenu.
Comparaison de contenuObservé
Mesuré en comparant le texte des pages d’une version à l’autre.
Propos de l’auteurRapporté
Les propos de l’auteur : un message de commit ou d’étiquette, le texte du site lui-même, ou un fait que l’auteur a consigné à la main dans cet historique, comme l’enregistrement du domaine.
InterprétationDéduit
Une lecture des indices, et non une observation directe.
IncertainNon établi
Non établi par les indices.

Méthode

Activité Git
Le premier et le dernier commit enregistrés pour une plateforme sur sa propre ligne : master pour Sphinx et Astro, la branche pour l’expérimentation DITA. Les travaux antérieurs sur une branche parallèle sont présentés à part. Ce ne sont pas des dates de mise en production.
Dates de production
Les dates de production sont celles pendant lesquelles une plateforme a servi le site public. L’activité Git ne prouve pas un déploiement : quand les indices sont muets, ces dates sont indiquées comme non documentées.
Périodes sans activité
Un intervalle d’au moins 240 jours entre deux commits consécutifs sur master, la ligne de production, classés par date de commit. Il ne dit rien de la disponibilité du site en ligne.
Rapprochement du contenu
Chaque page du dernier état Sphinx est rapprochée, par son texte et non par son nom de fichier, de l’import de 2014, de la branche DITA, du Markdown converti en septembre 2025 et de la page française actuelle. Git n’enregistre pas la conversion de 2025 comme des renommages : les noms de fichiers seuls ne permettent pas de relier les versions.

Détails techniques et sources

Comment les chiffres sont calculés, et chaque page historique avec l’endroit où se trouve son texte aujourd’hui.

Comment les scores et les chiffres dérivés sont calculés
Scores
Les scores mesurent la part des suites de cinq mots d’un texte antérieur qui se retrouvent dans le texte ultérieur. Les changements de balisage abaissent ce score : il faut le lire comme une approximation.
Chiffres dérivés
Certains chiffres sont calculés à partir de Git plutôt que lus directement. Pour l’âge des pages lors de la conversion de 2025, un commit compte comme une modification individuelle lorsqu’il touche 20 pages ou moins ; ne compter que les commits touchant une seule page donne une médiane plus ancienne. La correspondance avec pandoc compare les fichiers sans tenir compte des retours à la ligne. Git conserve une partie des outils de conversion, pas chaque étape.

Explorer la filiation

Chaque page historique et l’endroit où se trouve son texte aujourd’hui.

conservée comme page distincte39lors de la conversion de 2025

A gardé une page distincte lors de la conversion de 2025 et en a toujours une.

fusionnée dans une autre page62lors de la conversion de 2025

N’a plus de page distincte après la conversion ; au moins 30 % de son texte se retrouve dans une autre page.

  • texte désormais dans À propos d'Olivier Carrère (4)

    • Formats cibles
    • Formats sources
    • Les sources de ce blog sont gérées sous Git
    • Libérez vos informations de leurs silos
  • Documentation technique : diminuer les coûts, améliorer la satisfaction clientaujourd’hui : Documentation technique : diminuer les coûts, améliorer la satisfaction client
  • Format structuré DITA XMLaujourd’hui : Format structuré DITA XML

  • texte désormais dans Du document à la base documentaire modulaire (6)

    • Gérer son contenu DITA XML avec ou sans CMS ?
    • Le single-sourcing : un format source, plusieurs formats cibles
    • Les topics, modules d'information de base DITA XML
    • Organisation à la demande du contenu
    • Typologie de haut niveau de l'information
    • Un langage à balises

  • texte désormais dans Cas concret : documentation de NuFirewall (8)

    • Centraliser les conref dans un fichier unique
    • Fournir une information ciblée avec le texte conditionnel ditaval
    • Imbriquer les conref
    • Maximiser l'utilisation des conref pour faire baisser les coûts
    • Partager des blocs d'information atomiques avec les conref
    • Prendre en compte les contraintes de traduction
    • Protéger les informations confidentielles
    • Utiliser le nœud XML de plus bas niveau

  • texte désormais dans Formats structurés et non structurés (5)

    • DocBook ou DITA XML ?
    • Migration de FrameMaker vers DITA XML
    • Migrer de FrameMaker vers DITA XML
    • Restructuration du contenu FrameMaker
    • Table de conversion FrameMaker vers DITA XML

  • texte désormais dans Git : du fichier au contenu (2)

    • Faire sauter les goulets d'étranglement avec les branches
    • Organiser son historique avec Git rebase
  • Rédaction technique : un processus industrielaujourd’hui : Rédaction technique : un processus industriel

  • texte désormais dans Format source (3)

    • Documents monolithiques ou modulaires
    • Fichiers binaires ou texte
    • Qu'est-ce qu'un module d'information ?
  • Workflow de création et validationaujourd’hui : Validation et contrôle qualité

  • texte désormais dans Didacticiels DITA XML et XSL-FO (10)

    • Accélérer sa saisie avec le mode Predictive pour Emacs
    • Afficher un index dans un PDF (mais pas sous DITA Open Toolkit)
    • Créer des documents différents à partir des mêmes sources DITA XML (texte conditionnel)
    • DITA Open Toolkit : afficher les références croisées dans les PDF
    • Générer un PDF avec DITA Open Toolkit sous GNU/Linux
    • Générer un PDF avec DITA Open Toolkit (Windows)
    • Gérer les projets de documentation multilingues DITA XML
    • Utiliser l'IDE nXML pour DITA XML
    • XSL-FO : filtrer du contenu selon des conditions « sauf » et « ou »
    • XSL-FO : insérer automatiquement un titre pour les exemples

  • texte désormais dans Mener un projet de bout en bout (15)

    • Communication interne
    • Définition des rôles des membres du worfklow photo
    • Définition d'un workflow de gestion des photos
    • Didacticiels vidéo
    • Galerie photo centralisée dans le cloud
    • Gestion des photos d'une association
    • Iconographie
    • Indexation des photos
    • LaTeX
    • Patience…
    • Récupération et tri des photos
    • Sauvegarde incrémentale et décentralisée
    • Style rédactionnel
    • Suivi des modifications sous Git
    • Support papier

  • texte désormais dans Le Raspberry Pi 3 en tant que plateforme de documentation (5)

    • Configurez le Raspberry Pi 3
    • Créez et modifiez les schémas
    • Générez votre documentation
    • Gérez les versions de votre documentation
    • Installez les logiciels nécessaires à la gestion de ce blog
non reprise6lors de la conversion de 2025

Moins de 30 % de son texte se retrouve dans le site converti ou actuel.

Aucune page aujourd’hui

  • Contact
  • Créez et modifiez le texte
  • Une documentation en microservices
  • Persona : à quoi ressemblent vos utilisateurs ?
  • Le coin du geek
  • Récupérez les sources de ce blog
conservée, puis réécrite1après la conversion

A gardé une page distincte en 2025, mais la page actuelle conserve moins de la moitié du texte repris lors de la conversion.

reprise, puis supprimée2après la conversion

Convertie en 2025, puis supprimée.

Aucune page aujourd’hui

  • Jourdainisation en ligne d'une tirade ·
  • Un index est-il utile dans un PDF ? ·
écartée lors du nettoyage de 201438

Importée de WordPress et supprimée lors du nettoyage d’octobre-novembre 2014, avant la version 1.0. N’a jamais atteint le site Sphinx ultérieur.

Aucune page aujourd’hui

  • Animation Flash : partez à l'assaut du grand public ·
  • Appauvrissement volontaire du discours ·
  • Concept DITA XML ·
  • De la modularisation au partage de l'information ·
  • Des schémas, mais pas de captures d'écran ·
  • DITA Open Toolkit ·
  • DITA XML ·
  • Exemple d'animation Flash ·
  • Exemple : documentations d'une version libre et propriétaire d'un même logiciel ·
  • Faciliter le travail de groupe avec Subversion, cron et Emacs ·
  • Formats structurés ·
  • Guide de l'utilisateur : aidez vos clients, séduisez vos prospects ·
  • Les balises sont sémantiques ·
  • Livre blanc : mettez le contenu technique au service de votre communication marketing ·
  • Logiciel de gestion de versions ·
  • Logiciels de gestion de versions ·
  • Magazine d'entreprise : fidélisez vos clients et augmentez votre couverture médias ·
  • Minimalisme - moins, c'est plus ·
  • Modularisation du contenu ·
  • Outil de gestion de contenu d'entreprise ·
  • Partager des unités d'informations atomiques avec les conref ·
  • Placer le maximum d'information dans la structure ·
  • Plaquette commerciale, brochure ou flyer : rendez votre technologie attrayante ·
  • Rédaction structurée ·
  • Reference DITA XML ·
  • Répertoires ·
  • Séparation du format source et du format cible ·
  • Site web : convainquez tous vos publics, du décideur à l'expert ·
  • Spécialisation DITA XML ·
  • Structuration et hiérarchisation de l'information ·
  • Structure de table des matières : map ·
  • Task DITA XML ·
  • Tests de non-régression ·
  • Texte conditionnel ·
  • Typologie de l'information DITA XML ·
  • Un format adapté aux entreprises de toutes tailles ·
  • Workflow ·
  • XSL-FO : insérer du texte à partir des fichiers DITA ou des fichiers de variables ·