What Is a Single Source of Truth in Technical Documentation?

What is a Single Source of Truth in technical documentation?

A Single Source of Truth (SSOT) is the fundamental principle of structured authoring for technical documentation: each piece of content is written once, stored in one place, and then reused by reference in every document that needs it. When the source changes, the update automatically propagates throughout the documentation set. This principle directly opposes the copy-and-paste approach used in Word or InDesign and forms the foundation of every CCMS (Component Content Management System), including Calenco.

The Single Source of Truth principle explained simply

In technical documentation, the same content appears in many documents. A safety warning, maintenance procedure, technical specification, or legal notice may be included in instructions, manuals, product sheets, and training materials.

The key question is how that information is stored. Two approaches exist, and they produce radically different results.

The traditional duplication approach

In the traditional approach used with tools such as Word or Google Docs, every document contains its own copy of the information. A writer adds a safety warning to manual A, copies it into manual B, and then copies it again into product sheet C: three documents, three copies, and three separate locations.

The Single Source of Truth approach

With a Single Source of Truth, the warning exists as one item stored in the platform. Documents contain references to that unique content rather than copies: three documents, one source.

A useful analogy is an object placed in front of several mirrors. Change the object and every reflection changes immediately; there is no need to correct each reflection separately.

Why copy and paste creates a structural problem

Copying and pasting is not merely inefficient. It creates a structural information-consistency problem that grows with the size of the documentation set.

Multiplying manual operations

When information is duplicated ten times, updating it requires ten manual operations. Teams must identify every affected document, open them one by one, locate the passage, correct it, save it, and publish it again. Every step is an opportunity for error or omission.

Diverging versions

The direct result is version divergence. One document has been updated while another has not. Two manuals for the same product show different values for the same specification, and nobody knows which one is authoritative.

In regulated sectors such as industry, energy, and healthcare, this divergence is more than an inconvenience. It creates a compliance risk and potentially a safety risk.

Manual updates also consume considerable time without adding value: instead of creating content, teams repeat a correction that has already been made elsewhere.

How a Single Source of Truth works in a CCMS

In a CCMS (Component Content Management System), a Single Source of Truth is not merely a working method or a recommended practice. It is a technical reality enforced by the architecture of the system.

Dividing content into reusable components

Content is divided into reusable components. A component can be a paragraph, warning, procedure, image, or table. Calenco supports very fine granularity, making it possible to create reusable content consisting of a single word.

Each component is stored once with its own identifier in a reusable-content library. When writers create a document, they assemble existing modules from that library. The final document is an assembly of references rather than an accumulation of duplicated text.

Automatically propagating updates

When a source module changes, every document using it can be regenerated automatically. An entire documentation set is updated through a single operation, regardless of how many documents, languages, and publication formats it contains.

Single-source and multiformat publishing

A Single Source of Truth delivers its full value when paired with the separation of content and presentation.

In Calenco, writers focus exclusively on editorial content. At publication time, a stylesheet automatically applies the layout for the selected output format and the organization's visual identity.

From one source, the same document can be published as low- or high-resolution PDF, HTML, WebHelp, ePub, or delivered to tablets and smartphones. Content does not need to be adapted manually.

Without a Single Source of Truth, every format would require its own content version, creating more copies and more opportunities for divergence. Separating content from presentation is possible precisely because the content exists independently of its visual form.

Single-source and multilingual content management

Multilingual documentation is where a Single Source of Truth produces some of its most measurable benefits.

When documentation exists in twenty languages and each language is managed through separate files, changing source content requires twenty interventions, each carrying its own risk of omission.

Synchronizing translations

With a Single Source of Truth, the change is made once. Calenco then compares the updated source with the latest language version to identify exactly what needs to be translated. Translations remain synchronized with the original content.

Calenco connects to CAT (Computer-Assisted Translation) tools with translation memories and integrates with the Phrase localization platform. Stylesheets automatically lay out each language version, with no need for translators to adjust presentation.

Pellenc publishes technical manuals in twenty languages with Calenco and reduced translation costs by 60% after leaving InDesign.

What a Single Source of Truth changes in practice

The effects of single-source content can be measured in four areas.

Consistency

Because information exists only once, two documents cannot display contradictory values for the same data.

Reliability

Copy-and-paste errors disappear, along with obsolete versions left in circulation after an incomplete update.

Time

An entire documentation set can be updated through one change. Pellenc reduced writing time by 50% after moving from Word to Calenco.

Compliance

In regulated sectors, traceable information and confidence that every published document reflects the current source are requirements, not optional improvements.

The Single Source of Truth in Calenco

Calenco is a French CCMS published by NeoDoc, a document-engineering company founded in 2004 near Aix-en-Provence.

The platform applies the Single Source of Truth throughout the documentation lifecycle: every content module is stored once in a library, reused across documents, and updated in one place for every publication format.

Calenco is based on international open standards including XML and DocBook. This ensures long-term data durability and interoperability with existing systems without dependence on a proprietary format.

Use cases

Organizations including EDF, SNCF, Thales, and Pellenc use Calenco to produce and maintain technical documentation.

Til Technologies restructured its documentation set by identifying content shared between technical documentation and training materials, then converting it into reusable modules.

Summary

A Single Source of Truth means storing each piece of information once and reusing it by reference in every relevant document. It eliminates copies, which eliminates divergence and repeated manual updates.

It is the founding principle of structured authoring and the central mechanism of every CCMS. In Calenco, it applies across the entire documentation set, regardless of the number of documents, languages, or publication formats.