Skip to content
Redaction-technique.org

Tag: structured-authoring

6 articles tagged structured-authoring.

  • A document architecture that's too complex?

    DITA XML enables productivity gains by reducing the source volume that the technical writer creates, translates and maintains, at the cost of greater complexity.

  • Formats and tools

    When industrializing technical writing, the format matters more than the tool. Compare Word, Markdown, reStructuredText, DITA XML, and DocBook to find the right fit.

  • From document to modular document base

    DITA XML structured authoring moves documentation from monolithic books to a modular content base, enabling topic reuse, efficient translation, and multichannel output.

  • Source format

    Word processors have unaccustomed us to distinguishing between form and content. But confusing the two leads to many errors and wasted time.

  • Structured and unstructured formats

    Compare structured formats (DITA XML, DocBook) and unstructured formats (Word, PDF) for technical documentation: understand the trade-offs for reuse and translation.

  • The three levels of technical documentation

    Compare the three maturity levels of technical documentation — from informal notes to modular structured content — and find where your organization stands today.