Skip to content

Information typing

Documentation pages on Information typing (6 pages).

  • Example: a well-structured Markdown page

    A worked example of a concept article in Markdown, annotated to show why each structural choice was made.

  • Information types

    Understand information typing in technical documentation: how Concept, Task, and Reference divide content by reader intent, and how this relates to DITA, Markdown, and OpenAPI.

  • 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.

  • Template: concept article

    A practical authoring template for writing a concept article — an information type answering 'What is it?' with definitions, context, principles, and examples.

  • Template: reference article

    A ready-to-copy Markdown template for writing a reference article, following the Overview / Syntax / Parameters / Examples / Limitations structure.

  • Template: task article

    A ready-to-copy Markdown template for writing a task/tutorial article, following the Objective / Prerequisites / Steps / Expected result / Troubleshooting structure.

All topics