DITA as the standard for technical documentation
DITA (Darwin Information Typing Architecture) is an XML-based document format developed by OASIS in 2005, and since then, it has been available as a free DTD (Document Type Definition). DITA has established itself as a standard in technical documentation, enabling the creation, distribution, and reuse of technical information. Contents can be easily created and managed using topics. The modularity of DITA allows for efficient reuse of topics, which is particularly advantageous in technical communication, where numerous contents need to be repeatedly presented in different media.
Topics as the basis for structured information
The foundation of the standard is formed by the so-called “Topics,” which are used to capture technical information. Topics are small thematic units of information with a title and content that are self-contained and can be modularly reused. Each topic provides the appropriate answer to a specific question. DITA offers various types of topics and an information architecture that allows for sensible collection and organization of topics.
With the DITA Open Toolkit, a production environment is provided, which allows the created XML files to be transformed into various output formats, such as HTML or PDF.
DITA in technical communication
Subscribe to the free newsletter from PANTOPIX.
We will happily keep you regularly informed about new articles.
Combining different data sources in a knowledge database and the semantic representation of the information contained therein can make technical communication much easier. Building a knowledge base using semantic knowledge graphs offers numerous advantages, including the important possibility of continuously expanding the knowledge graph. One method of expanding knowledge is the use of knowledge graph embeddings.
The world of software development is constantly changing, and with it the way we document software. One innovative method that has gained popularity in recent years is “Docs-as-Code” or documentation as code. In this article, we will explore this exciting development and take a closer look at its application in technical documentation.