Home
DITA authoring concepts
Moving from style-based authoring to a structured authoring methodology such as DITA requires a radically different approach to writing.
Introduction to DITA
DITA is an XML standard, an architectural approach, and a writing methodology, developed by technical communicators for technical communicators.
The separation of content and form
Fundamental to structured authoring is the concept of the separation of content from presentation and delivery. The way a piece of text looks during authoring is irrelevant. The formatting and presentation are post-authoring considerations, and activities possibly not performed by a technical writer.

Introduction
Information types and topics
Topics are the building blocks of modular documents, and organising topics by semantic information types is one of the architectural features of DITA.
DITA map files
Syntax and mark-up
Language and punctuation
Graphics and figures
Cross-referencing
Cross-references are a means of binding individual topics into a coherent and navigable document.
Content re-use
Metadata, conditional processing, and indexing
The DITA documentation process
DITA authoring concepts
Moving from style-based authoring to a structured authoring methodology such as DITA requires a radically different approach to writing.
- Introduction to DITA
  DITA is an XML standard, an architectural approach, and a writing methodology, developed by technical communicators for technical communicators.
  - History of DITA
    DITA was originally developed within the technical publications department at IBM, but was donated to OASIS in 2004. It is now maintained by the OASIS DITA Technical Committee.
  - The A in DITA
    DITA provides a standardised architectural framework for creating and maintaining content.
  - OASIS and the DITA Technical Committee
    OASIS is a not-for-profit standards body, and membership is open to all. To participate in the ongoing development of the DITA standard, you must join OASIS.
  - DITA features
    DITA incorporates features designed to improve the quality and efficiency of documentation.
  - Information typing
    Information typing is a methodology which underpins DITA. Information is structured by topics with content models appropriate to the nature of the content. The three base DITA information types are concept, task and reference.
  - Topic-based authoring
    Content in DITA is authored in topics, rather than in larger documents or publications. A DITA topic must make sense in its own right. A topic is authored as a unit, not as part of a larger document.
  - Modularity
    DITA enables modular document development. Not only can topics be re-used, but any group of topics or elements can be treated as a modular document component.
  - Minimalism
    Particularly for procedural documentation, DITA topics should be written following the minimalism approach. Information should be arranged in succinct, action-oriented topics that help readers to understand quickly what they need to know.
  - Structured authoring
    Structured authoring can mean many things, but in the context of this document, structured authoring means a standardised, methodological approach to content creation incorporating systematic labelling, modular, topic-based architecture, constrained writing environments, and the separation of content and form.
  - The separation of content and form
    Fundamental to structured authoring is the concept of the separation of content from presentation and delivery. The way a piece of text looks during authoring is irrelevant. The formatting and presentation are post-authoring considerations, and activities possibly not performed by a technical writer.
  - Where DITA fits...
    DITA is technically defined as an XML application, and is therefore built on XML language standards. XML itself is based on other character representation rules. DITA can also be used in conjunction with related standards and technologies.
  - Inheritance
    Inheritance is a key technical feature of DITA, as it is inheritance that enables specialisation of information types.
  - Conditions, filtering, variants and ditaval
    Many confusing terms are used to describe different parts of the conditional publishing process. Understanding the terms is key to understanding the concepts.
  - Techniques to learn
    Authors moving from style-based authoring to structured authoring in a DITA environment will need to build chunking, labelling and linking skills, and to understand the technique of separation of content and form.
- Distinction between format and style, and data and metadata
  In DITA, format has a different meaning to style. Likewise, the meanings of data and metadata are very different. These distinctions in meaning are important to understanding the broader concept of the separation of content and form.
- Specialisation
  Specialisation allows you to construct your own types of documents without losing the benefits of working within a DITA framework; in particular, you can maintain interchangeability.
- Generalisation
  When information in a specialised information type needs to be converted into the information type from which it was specialised, the process is known as generalisation.
- Constraints
  The constraints mechanism in DITA allows the use of elements and attributes in an information type to be restricted without needing to create a full specialisation. Constraints aim to simplify the authoring process by reducing the complexity of an information type.

The separation of content and form

Fundamental to structured authoring is the concept of the separation of content from presentation and delivery. The way a piece of text looks during authoring is irrelevant. The formatting and presentation are post-authoring considerations, and activities possibly not performed by a technical writer.

DITA has no native presentation format. Tagging within DITA simply labels what the information is, and not what it looks like. A phrase within a sentence may be a window name, and that is how it is marked up. This approach is known as semantic mark-up. Whether a semantically marked-up phrase eventually gets displayed in bold, or in red, or in a box, or not at all, is determined later, outside the authoring process.

Documents are never displayed to the reader in DITA; DITA is not a presentation format. Content is almost completely separated from presentational form and delivery format. Wherever possible, context is also separated from content.

In order to make editing friendlier, many DITA editing programs display the DITA content in a graphical user interface. This approach is described as WYSIOO - What You See is One Option. What you see as a DITA author may be nothing like how the reader will perceive the document, but it is one display option! (WYSIOO is a play on the familiar term WYSIWYG, or What You See Is What You Get.)