Glossary Updates12 new terms added to the glossaries · 2 October 2026, 22:44 CEST
AI TechDocKnowledge
  • English (US)
  • English (UK)
  • Deutsch
All context cards

Context card

Every Page is Page One vs. semantic documentation

Is Every Page is Page One a form of semantic documentation?

By knowledge.aitechdoc.world

Reviewed

Review log and changes

The short answer

No — they are separate models that complement each other. Every Page is Page One, described by Mark Baker, is a model of writing: each page must work as the reader’s first page, establish its context and link richly. Semantic documentation is a model of representation: markup and metadata state in machine-readable form what content is about. Semantic metadata can make an EPPO page’s context readable for systems.

For: Technical writers, information architects and content strategists

Key points

  • EPPO concerns how a page is written and linked; semantic documentation concerns how meaning is encoded.
  • Baker names seven characteristics, among them “establishes its context” and “links richly”.
  • Semantic documentation uses markup, metadata and vocabularies such as taxonomies and ontologies.
  • The context an EPPO page states in text can also be recorded as metadata.
  • Neither model depends on a particular tool or markup language.

The context

Writing vs. representation

An Every Page is Page One page is self-contained, has one specific purpose, follows its type, establishes its context, assumes a qualified reader, stays on one level and links richly. These are criteria for writers and editors, not for software.

Semantic documentation encodes meaning: metadata classifies a topic by product, component, lifecycle phase and audience, using values from a taxonomy or ontology defined in an information model. Delivery standards such as iiRDS describe topics this way.

Where they meet

An EPPO page states its context for the reader; semantic metadata states the same context for systems. Together, a delivery portal or a knowledge graph can select the right page and generate links along defined relations. The EPPO Projects on this site show pages that name their context explicitly.

Questions readers ask next

Does EPPO require XML or DITA?
No. EPPO is a writing model and can be applied in any authoring or publishing environment.
Can semantic metadata replace the context in the text?
Not for readers. Metadata serves systems; the page still needs to tell its reader where it belongs.

Sources

  1. Every Page is Page One — XML Press
  2. iiRDS – the intelligent information Request and Delivery Standard — tekom

Review log and changes

Every context card is checked against its sources before it is published, and again whenever it changes; the date under the byline is the last review. Corrections (something was wrong) and additions (something was missing) are logged below with date and time (Berlin time). Typos, formatting and link fixes are not listed.

Reviewed

No corrections or additions since publication.