Skip to content
Olivier CarrèreTechnical writing practice

Publishing

Documentation pages on Publishing (5 pages).

This topic brings together 5 pages across the manual:

2 Concepts3 Tasks

  • Delivery

    Concept

    Learning path: 2. Build a documentation process

    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.

  • DITA XML and XSL-FO tutorials

    Task

    Learning path: 6. Automation & legacy techniques

    DITA XML structured authoring tutorials and XSL-FO stylesheet guides: create topic-based documentation and apply professional layouts for PDF and print output.

  • Example: a practical CI/CD pipeline for documentation

    Task

    Learning path: 5. Build your toolkitWorked examples

    A worked example of a documentation CI/CD pipeline - build, link check, search index, and deploy - annotated stage by stage.

  • Target format

    Concept

    Learning path: 4. Choose an authoring modelSource vs target formats

    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.

  • The Raspberry Pi 3 as a documentation platform

    Task

    Learning path: 6. Automation & legacy techniques

    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.

All topics