# Redaction-technique.org Documentation

> Technical documentation on DITA XML, Docs-as-Code, modular authoring, technical writing workflows, and content automation by Olivier Carrère.

## APIs and Discovery

- [English Documentation Sitemap](https://docs.redaction-technique.org/en/sitemap.md): Complete list of English docs with HTML and Markdown links
- [English Machine-Readable Index](https://docs.redaction-technique.org/en/index.json): Structured JSON metadata for all English documents
- [English Full Corpus](https://docs.redaction-technique.org/en/llms-full.txt): Consolidated Markdown text of all English documentation
- [French Documentation Sitemap](https://docs.redaction-technique.org/fr/sitemap.md): Plan complet de la documentation en français
- [French Machine-Readable Index](https://docs.redaction-technique.org/fr/index.json): Index structuré JSON des documents français
- [French Full Corpus](https://docs.redaction-technique.org/fr/llms-full.txt): Texte complet Markdown de toute la documentation en français
- [Complete Bilingual Corpus](https://docs.redaction-technique.org/llms-full.txt): Consolidated Markdown of all documentation (EN & FR)
- [Global JSON Index](https://docs.redaction-technique.org/index.json): Complete machine-readable index across all languages

## English Documentation

### Home

- [Technical Writing, Step by Step - Olivier Carrère](https://docs.redaction-technique.org/en/): Expert guides on technical writing, DITA XML, Markdown, docs-as-code, and content automation for technical communicators and documentation engineering teams.

### About this blog

- [About this blog](https://docs.redaction-technique.org/en/about-this-blog/): A technical writing blog specializing in DITA XML, docs-as-code, documentation automation, and technical communication, by Olivier Carrère, technical writer.

### Technical writing: An industrial process

- [Project definition](https://docs.redaction-technique.org/en/tech-writing-process/project-definition/): Define your technical documentation project before writing: identify the audience, scope, deliverables, and success criteria to guide the entire editorial process.
- [Gathering information](https://docs.redaction-technique.org/en/tech-writing-process/gathering-information/): How technical writers gather information: expert interviews, product testing, existing documentation, and field observations to build accurate and useful content.
- [Testing products to document them](https://docs.redaction-technique.org/en/tech-writing-process/testing-products/): A technical writer must test the product in real user conditions before documenting it, not merely compile what stakeholders say - cutting through their partial views and the information loss that undermines accuracy.
- [Source format](https://docs.redaction-technique.org/en/tech-writing-process/source-format/): Word processors have unaccustomed us to distinguishing between form and content. But confusing the two leads to many errors and wasted time.
- [Target format](https://docs.redaction-technique.org/en/tech-writing-process/target-format/): The target format is what end users consume - PDF, HTML, or compiled help - generated from a single source. Learn the difference between fully automatic, semi-automatic, and manual publishing.
- [Content creation](https://docs.redaction-technique.org/en/tech-writing-process/content-creation/): The technical writer creates the content of the technical writing project in constant dialogue with the company's various stakeholders, such as R&D and marketing.
- [Integrating documentation into development processes](https://docs.redaction-technique.org/en/tech-writing-process/integrating-documentation-into-development/): Learn why technical documentation should be released, versioned, and quality-controlled alongside the product, using text formats like DocBook, DITA XML, and reStructuredText.
- [Version management systems - rustic but reliable](https://docs.redaction-technique.org/en/tech-writing-process/version-control-systems/): Use Git or Subversion to manage technical documentation like source code: track changes, collaborate with your team, and roll back safely at any time.
- [Git: from file to content](https://docs.redaction-technique.org/en/tech-writing-process/git-from-file-to-content/): Think content rather than files with Git: branches, commits, and diffs for technical documentation make collaboration and version management far simpler and safer.
- [Using branches in source management systems](https://docs.redaction-technique.org/en/tech-writing-process/using-branches/): Use Git branches to manage parallel documentation projects, product variants, and translation workflows without conflicts - a practical guide for technical writers.
- [Repository](https://docs.redaction-technique.org/en/tech-writing-process/repository/): Content is a company's intangible capital. Learn how to choose and manage a documentation repository to protect, version, and share technical content across teams.
- [A single repository?](https://docs.redaction-technique.org/en/tech-writing-process/single-repository/): A single Git repository for all technical documentation content maximizes reuse, consistency, and quality while simplifying collaboration across writing and dev teams.
- [Which repository for group work?](https://docs.redaction-technique.org/en/tech-writing-process/which-repository-for-group-work/): Why folders and shared network drives fall short for collaborative technical writing: concurrent edits overwrite one another and file locking blocks batch changes - problems that version-control systems solve reliably.
- [Shared network directories - unsuitable for group work](https://docs.redaction-technique.org/en/tech-writing-process/shared-network-directories/): Shared network drives are a common but inadequate solution for team documentation collaboration. Learn why they fail and what version-control alternatives work better.
- [SQL database](https://docs.redaction-technique.org/en/tech-writing-process/sql-database/): In a CMS like Drupal, Joomla, or WordPress, technical content lives in an SQL database that keeps only per-article history and cannot search and replace across all content - one reason to manage it as text files instead.
- [CMS: workflow as a bonus, but reliability to be tested](https://docs.redaction-technique.org/en/tech-writing-process/cms-workflow-and-reliability/): A CMS like SharePoint or Alfresco adds workflow and file-locking to technical writing, and some (DocZone, Componize) even handle DITA XML - but their reliability for archiving source files must be tested and backed by a solid backup strategy.
- [Validation and quality control](https://docs.redaction-technique.org/en/tech-writing-process/validation-quality-control/): Validate technical documentation before delivery: run validation in parallel with writing, track every change request through a CMS workflow or a ticketing system, and use comparison tools to review updates reliably.
- [Translation](https://docs.redaction-technique.org/en/tech-writing-process/translation/): Plan translation from the start of your documentation project: tackle it early to cut costs and delivery times, translate modular content in parallel with writing, and organize source repositories language-first.
- [Delivery](https://docs.redaction-technique.org/en/tech-writing-process/delivery/): Delivery is the final step: validated content reaches its audiences through the format and channel chosen at project definition, from animations and brochures to newsletters, website updates, and printed or PDF guides.
- [Technical writing: an industrial process](https://docs.redaction-technique.org/en/tech-writing-process/): Explore the complete technical writing process: project definition, information gathering, content creation, validation, translation, and delivery to end users.

### Tutorials

- [Auto-insert data into a DITA XML file](https://docs.redaction-technique.org/en/tutorials/auto-insert-data-dita-xml/): Automate DITA XML file generation with Python: dynamically insert product data into DITA topics to industrialize technical documentation.
- [Automatically insert data into a reStructuredText file](https://docs.redaction-technique.org/en/tutorials/auto-insert-data-restructuredtext/): Automatically insert product data into reStructuredText documentation with Python - generate per-product version lists from structured data files.
- [Automatically insert SQL data into a reStructuredText file](https://docs.redaction-technique.org/en/tutorials/auto-insert-sql-data-restructuredtext/): Create a product database with Python and SQLite, then automatically generate formatted reStructuredText documentation from the data - a practical docs-as-code tutorial.
- [Create different documents from the same ReST sources (conditional text)](https://docs.redaction-technique.org/en/tutorials/conditional-text-sphinx-rest/): Generate multiple document variants - user guide, admin guide, lite edition - from the same reStructuredText sources using Sphinx conditional text directives.
- [Create different documents from the same sources using Jinja](https://docs.redaction-technique.org/en/tutorials/conditional-text-jinja/): Profile reStructuredText content with Jinja and a Python preprocessing script to generate audience-specific document variants - user, admin, lite - from a single source.
- [Create different documents from the same sources via Jinja (object method)](https://docs.redaction-technique.org/en/tutorials/conditional-text-jinja-object-method/): Profile content with Jinja by defining objects (audience, platform, version) to include or exclude blocks according to their attributes using a Python profiling script.
- [DITA XML and XSL-FO tutorials](https://docs.redaction-technique.org/en/tutorials/dita-xml-xsl-fo-tutorials/): DITA XML structured authoring tutorials and XSL-FO stylesheet guides: create topic-based documentation and apply professional layouts for PDF and print output.
- [Managing a project from start to finish](https://docs.redaction-technique.org/en/tutorials/project-end-to-end/): It's pretty rare, in a professional context, to be able to manage a project from (almost) A to Z, from conception to realization and communication.
- [Regular expressions in Python](https://docs.redaction-technique.org/en/tutorials/python-regular-expressions/): Use Python's re library to search, extract, and transform text in documentation files - a practical regex guide for technical writers working with automation scripts.
- [sed: modify your text without opening your files](https://docs.redaction-technique.org/en/tutorials/sed-text-editing/): Learn to use sed, the Unix stream editor, to batch-edit technical documentation files without opening them - perfect for automating repetitive content updates.
- [The Raspberry Pi 3 as a documentation platform](https://docs.redaction-technique.org/en/tutorials/raspberry-pi-documentation-platform/): Set up a complete documentation platform on a Raspberry Pi 3: install Sphinx, generate PDF, HTML, and EPUB from reStructuredText, and manage content with Git.
- [Tutorials](https://docs.redaction-technique.org/en/tutorials/): Practical guides for automating, authoring, and publishing technical documentation with Python, Jinja, reStructuredText, and DITA XML.

### Structured DITA XML format

- [Case studies in using DITA XML](https://docs.redaction-technique.org/en/formats/dita-xml-case-studies/): Practical DITA XML solutions and tips developed through daily multilingual technical writing projects - structured authoring, topic reuse, conditional text, and publishing.
- [Case study: NuFirewall documentation](https://docs.redaction-technique.org/en/formats/nufirewall-case-study/): NuFirewall's documentation, praised by the press as a product strength, was built with DITA XML - a case study in structured authoring for software product documentation.
- [From document to modular document base](https://docs.redaction-technique.org/en/formats/modular-documentation/): DITA XML structured authoring moves documentation from monolithic books to a modular content base, enabling topic reuse, efficient translation, and multichannel output.
- [Structured and unstructured formats](https://docs.redaction-technique.org/en/formats/structured-vs-unstructured-formats/): Compare structured formats (DITA XML, DocBook) and unstructured formats (Word, PDF) for technical documentation: understand the trade-offs for reuse and translation.
- [Structured DITA XML format](https://docs.redaction-technique.org/en/formats/): Reduce production costs and delivery time in technical documentation by choosing the right format, structured authoring approach, and modular content reuse strategies.
- [Too complex a document architecture?](https://docs.redaction-technique.org/en/formats/document-architecture-complexity/): DITA XML enables productivity gains by reducing the source volume that the technical writer creates, translates and maintains, at the cost of greater complexity.

### Reduce costs, increase customer satisfaction

- [Formats and tools](https://docs.redaction-technique.org/en/costs/formats-and-tools/): When industrializing technical writing, the format matters more than the tool. Compare proprietary formats like Word and FrameMaker against open standards like DITA XML and DocBook to find the right fit.
- [From technical writing to technical communication](https://docs.redaction-technique.org/en/costs/copywriting-to-technical-communication/): Technical communication is often reduced to technical writing. Technical writing provides product documentation and sits downstream of the sale.
- [Is an index useful in a PDF?](https://docs.redaction-technique.org/en/costs/index-in-pdf/): Is an index still useful in a PDF manual in the age of full-text search? Explore the pros and cons for technical documentation and help content usability.
- [KISS Principle of Simplicity](https://docs.redaction-technique.org/en/costs/kiss-principle/): The KISS principle (Keep it simple stupid) is a general engineering principle that advocates simplicity to improve reliability, maintenance and scalability.
- [Technical documentation: reduce costs, improve customer satisfaction](https://docs.redaction-technique.org/en/costs/): Reduce documentation costs, accelerate time to market, and improve quality through industrial technical writing practices, modular content, and structured authoring.
- [The three levels of technical documentation](https://docs.redaction-technique.org/en/costs/three-levels-of-documentation/): Compare the three maturity levels of technical documentation - from informal notes to modular structured content - and see what sets each stage apart.

### 🤖 Ask the documentation

- [Ask the documentation](https://docs.redaction-technique.org/en/ask/): Ask a question about the technical writing documentation and get an AI-generated answer based on the site's content.

### Example

- [Example Guide](https://docs.redaction-technique.org/guides/example/): A step-by-step guide to technical writing workflows, structured authoring, and documentation automation for software and product documentation teams.
- [Example Reference](https://docs.redaction-technique.org/reference/example/): Reference documentation for technical writing tools, formats, and workflows: DITA XML, Markdown, reStructuredText, Git, and content automation scripts.

## Documentation en français

### Accueil

- [Rédaction technique, étape par étape - Olivier Carrère](https://docs.redaction-technique.org/fr/): Guides experts en rédaction technique, DITA XML, Markdown, docs-as-code et automatisation de contenu pour les communicants techniques et équipes documentation.

### À propos de ce blog

- [À propos de ce blog](https://docs.redaction-technique.org/fr/about-this-blog/): Blog de rédaction technique spécialisé en DITA XML, docs-as-code, automatisation de la documentation et communication technique, par Olivier Carrère, rédacteur technique.

### Rédaction technique : un processus industriel

- [Définition du projet](https://docs.redaction-technique.org/fr/tech-writing-process/project-definition/): Définissez votre projet de documentation technique avant d'écrire : identifiez le public cible, le périmètre, les livrables et les critères de succès du processus.
- [Collecte de l’information](https://docs.redaction-technique.org/fr/tech-writing-process/gathering-information/): Collecte d'information en rédaction technique : interviews d'experts, tests produit, documentation existante et observations terrain pour construire un contenu précis.
- [Tester les produits pour les documenter](https://docs.redaction-technique.org/fr/tech-writing-process/testing-products/): Le rédacteur technique doit tester le produit dans des conditions proches de celles de l'utilisateur avant de le documenter, plutôt que de compiler les avis partiels des acteurs de l'entreprise - source d'erreurs et de déperdition d'information.
- [Format source](https://docs.redaction-technique.org/fr/tech-writing-process/source-format/): Les traitements de texte nous ont déshabitués à distinguer le fond de la forme. Mais confondre les deux entraîne beaucoup d'erreurs et de perte de temps.
- [Format cible](https://docs.redaction-technique.org/fr/tech-writing-process/target-format/): Le format cible est celui que les utilisateurs consomment - PDF, HTML ou aide compilée - généré à partir d'une source unique. Découvrez la différence entre publication totalement automatique, semi-automatique et manuelle.
- [Création du contenu](https://docs.redaction-technique.org/fr/tech-writing-process/content-creation/): Le rédacteur technique crée le contenu du projet de rédaction technique dans un dialogue constant avec les différents acteurs de la société : services R&D, marketing.
- [Intégrer la documentation aux processus de développement](https://docs.redaction-technique.org/fr/tech-writing-process/integrating-documentation-into-development/): Découvrez pourquoi la documentation technique doit être livrée, versionnée et contrôlée en même temps que le produit, grâce aux formats texte comme DocBook, DITA XML et reStructuredText.
- [Les systèmes de gestion de versions - rustiques mais fiables](https://docs.redaction-technique.org/fr/tech-writing-process/version-control-systems/): Gérez la documentation technique avec Git ou Subversion comme du code source : suivez les modifications, collaborez en équipe et restaurez des versions.
- [Git : du fichier au contenu](https://docs.redaction-technique.org/fr/tech-writing-process/git-from-file-to-content/): Pensez contenu plutôt que fichiers avec Git : branches, commits et diffs pour la documentation technique simplifient la collaboration et la gestion des versions.
- [Utiliser les branches des systèmes de gestion de sources](https://docs.redaction-technique.org/fr/tech-writing-process/using-branches/): Utilisez les branches Git pour gérer des projets documentaires parallèles, des variantes produit et des workflows de traduction sans conflits - guide pratique rédacteur.
- [Référentiel](https://docs.redaction-technique.org/fr/tech-writing-process/repository/): Le contenu technique est un capital immatériel précieux. Découvrez comment choisir et gérer un référentiel documentaire pour le versionner, le protéger et le partager.
- [Un référentiel unique ?](https://docs.redaction-technique.org/fr/tech-writing-process/single-repository/): Un référentiel Git unique pour la documentation technique maximise la réutilisation, la cohérence et la qualité, tout en simplifiant la collaboration en équipe.
- [Quel référentiel pour le travail de groupe ?](https://docs.redaction-technique.org/fr/tech-writing-process/which-repository-for-group-work/): Pourquoi les dossiers et disques réseau partagés montrent leurs limites en travail de groupe : les modifications concurrentes s'écrasent, le verrouillage des fichiers bloque les changements par lot et impose une coordination de tous les instants.
- [Les répertoires réseau partagés - peu adaptés au travail de groupe](https://docs.redaction-technique.org/fr/tech-writing-process/shared-network-directories/): Les répertoires réseau partagés sont une solution inadaptée pour la documentation d'équipe. Pourquoi ils posent problème et quelles alternatives choisir pour collaborer.
- [Base de données SQL](https://docs.redaction-technique.org/fr/tech-writing-process/sql-database/): Dans un CMS comme Drupal, Joomla ou WordPress, le contenu documentaire est stocké en base SQL, qui ne conserve qu'un historique article par article et interdit la recherche-remplacement globale - d'où l'intérêt de le gérer en fichiers texte.
- [Les CMS : le workflow en prime, mais une fiabilité à tester](https://docs.redaction-technique.org/fr/tech-writing-process/cms-workflow-and-reliability/): Un CMS comme SharePoint ou Alfresco apporte workflow et verrouillage des fichiers à la rédaction technique, et certains (DocZone, Componize) gèrent même DITA XML - mais leur fiabilité pour archiver les sources reste à tester, adossée à une sauvegarde éprouvée.
- [Validation et contrôle qualité](https://docs.redaction-technique.org/fr/tech-writing-process/validation-quality-control/): Validez la documentation technique avant livraison : menez la validation en parallèle de la rédaction, tracez chaque demande de modification via un workflow CMS ou un système de tickets, et comparez les versions pour fiabiliser les mises à jour.
- [Traduction](https://docs.redaction-technique.org/fr/tech-writing-process/translation/): Planifiez la traduction dès le début du projet documentaire : anticipez-la pour réduire coûts et délais, traduisez le contenu modulaire en parallèle de la rédaction, et organisez le référentiel source par langue.
- [Livraison](https://docs.redaction-technique.org/fr/tech-writing-process/delivery/): La livraison est l'étape finale : le contenu validé atteint ses cibles via le format et le canal définis au lancement du projet, de l'animation à la plaquette, en passant par les journaux clients, le site web et le guide imprimé ou PDF.
- [Rédaction technique : un processus industriel](https://docs.redaction-technique.org/fr/tech-writing-process/): Découvrez le processus complet de rédaction technique : définition du projet, collecte d'information, création de contenu, validation, traduction et livraison.

### Didacticiels

- [Créer des documents différents à partir des mêmes sources ReST (texte conditionnel)](https://docs.redaction-technique.org/fr/tutorials/conditional-text-sphinx-rest/): Générez plusieurs variantes de documents depuis les mêmes sources reStructuredText avec le texte conditionnel Sphinx - guide utilisateur, édition admin, édition lite.
- [Créer des documents différents à partir des mêmes sources via Jinja](https://docs.redaction-technique.org/fr/tutorials/conditional-text-jinja/): Profilez du contenu reStructuredText avec Jinja et Python en prétraitement pour générer des variantes de documents spécifiques au public depuis une source unique.
- [Créer des documents différents à partir des mêmes sources via Jinja (méthode objet)](https://docs.redaction-technique.org/fr/tutorials/conditional-text-jinja-object-method/): Profilez du contenu reStructuredText avec Jinja en définissant des objets (audience, plateforme, version) pour inclure ou exclure des blocs selon leurs attributs.
- [Didacticiels](https://docs.redaction-technique.org/fr/tutorials/): Guides pratiques pour automatiser, rédiger et publier la documentation technique avec Python, Jinja, reStructuredText et DITA XML.
- [Didacticiels DITA XML et XSL-FO](https://docs.redaction-technique.org/fr/tutorials/dita-xml-xsl-fo-tutorials/): Tutoriels DITA XML et XSL-FO : créez une documentation topic par topic et appliquez des mises en page professionnelles pour la sortie PDF et l'impression.
- [Expressions régulières en Python](https://docs.redaction-technique.org/fr/tutorials/python-regular-expressions/): Utilisez la bibliothèque re de Python pour rechercher, extraire et transformer du texte dans vos fichiers de documentation - guide pratique avec patterns regex.
- [Insérer automatiquement des données dans un fichier DITA XML](https://docs.redaction-technique.org/fr/tutorials/auto-insert-data-dita-xml/): Automatisez la génération de fichiers DITA XML avec Python : insérez des données produit dynamiques dans vos topics DITA pour industrialiser la documentation technique.
- [Insérer automatiquement des données dans un fichier reStructuredText](https://docs.redaction-technique.org/fr/tutorials/auto-insert-data-restructuredtext/): Insérez automatiquement des données produit dans vos fichiers reStructuredText avec Python pour générer des listes de versions par produit à partir de données structurées.
- [Insérer automatiquement des données SQL dans un fichier reStructuredText](https://docs.redaction-technique.org/fr/tutorials/auto-insert-sql-data-restructuredtext/): Nous allons créer une base de données de produits avec leurs versions, puis mettre en forme ces informations dans un fichier reStructuredText.
- [Le Raspberry Pi 3 en tant que plateforme de documentation](https://docs.redaction-technique.org/fr/tutorials/raspberry-pi-documentation-platform/): Configurez une plateforme de documentation complète sur Raspberry Pi 3 : Sphinx, Git, et génération PDF, HTML et EPUB depuis des sources reStructuredText.
- [Mener un projet de bout en bout](https://docs.redaction-technique.org/fr/tutorials/project-end-to-end/): Il est assez rare, dans le cadre professionnel, de pouvoir mener un projet de (quasiment) A à Z, de la conception à la communication, en passant par la réalisation.
- [sed : modifiez votre texte sans ouvrir vos fichiers](https://docs.redaction-technique.org/fr/tutorials/sed-text-editing/): Utilisez sed, l'éditeur de flux Unix, pour modifier en lot vos fichiers de documentation technique sans les ouvrir - idéal pour automatiser les mises à jour de contenu.

### Format structuré DITA XML

- [Cas concret : documentation de NuFirewall](https://docs.redaction-technique.org/fr/formats/nufirewall-case-study/): La documentation NuFirewall, saluée par la presse comme un atout produit, a été réalisée en DITA XML - étude de cas en authoring structuré pour logiciel informatique.
- [Cas concrets d’utilisation de DITA XML](https://docs.redaction-technique.org/fr/formats/dita-xml-case-studies/): Solutions et astuces DITA XML développées au quotidien sur des projets multilingues : réutilisation de topics, texte conditionnel, traduction et publication multicanal.
- [Du document à la base documentaire modulaire](https://docs.redaction-technique.org/fr/formats/modular-documentation/): DITA XML permet de passer du livre monolithique à la base documentaire modulaire pour réutiliser les topics, optimiser la traduction et publier en multicanal.
- [Format structuré DITA XML](https://docs.redaction-technique.org/fr/formats/): Réduisez les coûts et délais en rédaction technique en choisissant le bon format d'authoring structuré et en optimisant la réutilisation du contenu documentaire.
- [Formats structurés et non structurés](https://docs.redaction-technique.org/fr/formats/structured-vs-unstructured-formats/): Comparez les formats structurés (DITA XML, DocBook) et non structurés (Word, PDF) pour la documentation technique : réutilisation, traduction et évolutivité.
- [Une architecture documentaire trop complexe ?](https://docs.redaction-technique.org/fr/formats/document-architecture-complexity/): DITA XML permet des gains de productivité en réduisant le volume source que le rédacteur technique crée, traduit et maintient, au prix d'une plus grande complexité.

### Diminuer les coûts, augmenter la satisfaction client

- [De la rédaction à la communication technique](https://docs.redaction-technique.org/fr/costs/copywriting-to-technical-communication/): La communication technique ne se réduit pas à la rédaction produit. Découvrez leur différence de périmètre et la valeur ajoutée de la communication technique.
- [Documentation technique : diminuer les coûts, améliorer la satisfaction client](https://docs.redaction-technique.org/fr/costs/): Réduisez les coûts de documentation et améliorez la qualité grâce à la rédaction technique industrielle, au contenu modulaire DITA XML et à l'authoring structuré.
- [Formats et outils](https://docs.redaction-technique.org/fr/costs/formats-and-tools/): Pour industrialiser la rédaction technique, le format importe plus que l’outil. Comparez les formats propriétaires comme Word et FrameMaker aux standards ouverts comme DITA XML et DocBook pour votre contexte.
- [Les trois niveaux de la documentation technique](https://docs.redaction-technique.org/fr/costs/three-levels-of-documentation/): Comparez les trois niveaux de maturité de la documentation technique - des notes informelles au contenu modulaire structuré - et découvrez ce qui distingue chaque niveau.
- [Principe de simplicité KISS](https://docs.redaction-technique.org/fr/costs/kiss-principle/): Le principe KISS (Keep it simple stupid) est un principe général d’ingénierie qui préconise la simplicité pour améliorer fiabilité, maintenance et évolutivité.
- [Un index est-il utile dans un PDF ?](https://docs.redaction-technique.org/fr/costs/index-in-pdf/): Un index est-il encore utile dans un PDF à l'ère de la recherche en plein texte ? Analyse des avantages et inconvénients pour la documentation technique et les PDF.

### 🤖 Interroger la documentation

- [Interroger la documentation](https://docs.redaction-technique.org/fr/ask/): Posez une question sur la documentation et obtenez une réponse fondée sur son contenu.