Technical documentation models

Semantic documentation

Also known as: Semantically enriched documentation · Intelligent information · Semantic technical documentation

Semantic documentation is a model of technical documentation in which the meaning of content — its subject, the product it applies to, its purpose and its relations — is represented explicitly in machine-readable form. Markup and metadata describe what content is about rather than only how it is displayed. Semantic documentation makes content selectable, connectable and processable by systems, including search engines, content delivery portals and AI applications.

By knowledge.aitechdoc.world · Last reviewed October 1, 2026

Definition

Semantic documentation describes content by its meaning. Two levels are distinguished: semantics inside the content, expressed by markup that names the subject of an element (for example a parameter, a torque value or a hazard), and semantics about the content, expressed by metadata that classifies a unit by product, component, lifecycle phase, information type and audience. Both levels refer to controlled vocabularies, taxonomies or ontologies, so that systems interpret the descriptions consistently.

Historical development

Descriptive markup in SGML and XML separated content from presentation from the 1980s onward. Topic architectures added information types, and classification schemes added product and audience metadata for filtering. Semantic web technologies such as RDF and OWL provided formal models for shared vocabularies. In technical communication, delivery standards such as iiRDS, published by tekom, defined a common ontology for metadata of technical documentation so that content from different manufacturers can be processed by the same delivery systems. Mark Baker’s work on structured writing distinguishes subject-domain markup, which records the subject matter, from document-domain and media-domain markup.

Components

Semantic markup. Elements and attributes that name what content is about.
Metadata. Properties of content units, often split into administrative and descriptive metadata.
Vocabularies. Controlled lists, taxonomies and ontologies that define permitted values and their relations.
Information model. A technology-neutral model of the content types, metadata and relations of a documentation set.
Delivery formats. Packages that carry content together with its metadata, such as iiRDS packages.

Function and purpose

Semantic documentation allows content to be retrieved by product and situation, assembled dynamically, exchanged between organizations and linked to product data, service systems and knowledge graphs. It is a precondition for reliable use of documentation by AI systems, which depend on accurate context to select and cite the right content.

Applications

The model is applied in content delivery portals for machinery and equipment, service and maintenance applications, digital twins and product data exchange, and retrieval-augmented AI assistants for documentation.

Limitations

Semantic enrichment requires agreed vocabularies and consistent tagging. Metadata that is incomplete or applied inconsistently reduces retrieval quality and can mislead systems that rely on it. Maintaining ontologies and their mappings across organizations is a long-term governance task.

Relation to other models

Semantic documentation complements topic-based documentation, which provides the units, and structured authoring, which provides the markup. It makes EPPO’s requirement that a page establish its context machine-readable.

Conclusion

Semantic documentation shifts the description of technical content from appearance to meaning. Its benefits depend on shared vocabularies and on the discipline with which they are applied.

Cite this article

knowledge.aitechdoc.world. “Semantic documentation.” Encyclopedia, AI TechDoc Blog. Last reviewed October 1, 2026. https://knowledge.aitechdoc.world/encyclopedia/technical-documentation-models/semantic-documentation

Glossary terms

Metadata

In information management, metadata is data that describes other data or resources, such as their meaning, origin, format, units, owner, time stamp, version or classification, so that they can be found, understood, managed and used correctly.

Taxonomy

In information management, a taxonomy is a controlled vocabulary of concepts arranged in a hierarchy of broader and narrower terms, used to classify and find information, products or data consistently.

Ontology

In information science, an ontology is a formal, explicit specification of the concepts of a domain, their properties and the relationships between them, often including logical rules, so that both people and machines can interpret data consistently. Ontologies are commonly expressed in languages such as RDF Schema and OWL.

Information model

In information architecture, an information model is a technology-neutral model of concepts, relationships, rules and information requirements. It describes what information a domain needs and what it means, before any choice of database, format or protocol.

Knowledge graph

A knowledge graph is a network of entities — such as products, components, functions and documents — and the typed relationships between them, stored in a machine-readable form such as RDF, so that people and AI systems can query and reason over connected knowledge.

RDF (Resource Description Framework)

RDF (Resource Description Framework) is the W3C standard data model for describing resources as statements of subject, predicate and object, called triples. Resources and predicates are identified by IRIs, so statements from different sources can be merged into one graph.

iiRDS Topic

In iiRDS (intelligent information Request and Delivery Standard), a Topic is an information unit that deals with a single subject and can be understood on its own — for example one task, one concept or one reference table.

iiRDS InformationType

In iiRDS (intelligent information Request and Delivery Standard), InformationType is the class for the characteristics of content. Its subclasses classify information units by document type (such as operating instructions), topic type (such as task or concept), information subject (such as safety) and directory node type (such as a table of contents).

Semantic interoperability

In information exchange, semantic interoperability is the ability of different systems to exchange data with an unambiguous, shared meaning, so that the receiving system interprets and uses the data as the sender intended without manual translation. It builds on technical and syntactic interoperability and requires shared information models, vocabularies or semantic identifiers.