Sign inBook a demo

Living documentation

What changes when documentation keeps up.

Most documentation describes the system as it was at go-live. A living record is regenerated from the configuration itself, so it describes the system as it runs right now. The maintenance it saves is easy to count — and it is the smallest part of the case.

The difference

The same workflow, two records.

Below, the same workflow documented twice. On the left, the export everyone knows: accurate the day it was written, wrong in silence ever since. On the right, a living record.

Ivalua · workflow · export

Purchase request workflow

Exported to PDF on 14 March 2025 · 23 configuration changes since

Out of date

Maintained by hand, after each release, when someone has time. Nobody can say which pages are still true.

Ivalua · workflow · v4.2

Purchase request workflow

Extracted from PROD on 20 November 2026 · regenerated after every change

Verified

Maintained by no one. Generated from the configuration, with its version, environment and extraction date on every page.

The business case

Savings are where the case starts, not where it ends.

The first benefit is the one every budget understands: no one rewrites documents after each release, no one reconstructs the configuration before an audit, and the integrator's days stop going into keeping files honest. That saving is real and easy to count.

But removed cost is only half the ledger. A record the whole team trusts starts earning: faster decisions, faster onboarding, safer releases, shorter tickets. The maintenance line shrinks once; the rest compounds every week. The sections below take them one by one.

What it stops costing

  • Rewriting documents after every release
  • Reconciling three versions of the truth before each workshop
  • Experts answering the same questions again and again
  • Reconstructing the configuration before every audit

What it starts earning

  • Decisions made on facts, recorded against a version
  • New joiners productive in their first week
  • Releases reviewed field by field before they ship
  • Support tickets that start at the cause
  • A record you can navigate, search and ask

Reliability

A record the team can rely on.

Documentation decays in silence. A threshold moves, a role is renamed, and the page that described them stays as it was. Readers learn to double-check every page — and documentation that has to be double-checked has already lost its job.

A living record carries its proof on the page: the version, the environment, the extraction date, a verified mark renewed at every regeneration. The question “is this still true?” stops being asked. People act on what they read.

Purchase request workflow · version history Verified
  • v4.2 21 October 2026Approver changed on PR_HIGH_VALUE: Head of Procurement
  • v4.1 7 October 2026Notification step added after approval
  • v4.0 29 September 2026Initial extraction from PROD
Every version reproducible from its configuration

Alignment

One reference that ends the meeting before the meeting.

When business, IT and the integrator each keep their own notes, every workshop starts with twenty minutes of reconciliation: whose version of the workflow are we even discussing?

A single current record ends that. The process owner reads the outcome, the architect reads the configuration underneath, and both point at the same page. Decisions are recorded against a version, so the next meeting starts where the last one ended instead of replaying it.

Approval rules · PROD · v4.2
RuleThresholdApprover
PR_STANDARDUp to €10,000Buyer
PR_HIGH_VALUEAbove €10,000Head of Procurement

Steering committee · 14 October 2026

“Approvals above €10,000 move to the Head of Procurement.”

Recorded against approval_rules · v4.2 · PROD

Training

Onboarding without archaeology.

New joiners usually learn the system from a deck written three releases ago, then unlearn half of it during their first month. The real knowledge lives in a few heads, and those heads are the bottleneck.

With a living record, the training material is the system. A new buyer, consultant or administrator reads pages that are verified against the actual system the week they arrive — and the expert's calendar stops deciding how fast the team grows.

Onboarding · week 1
  • Day 1Environments and scope
  • Day 2Roles and permissions
  • Day 3Purchase request workflow, end to end
  • Day 4Approval rules, with the live thresholds
  • Day 5Shadow a buyer, record open

VerifiedEvery section verified against PROD on 20 November 2026

Product brainstorms

Ideas tested against reality, in the room.

Most workshop ideas die two weeks later, when someone finally checks the configuration and finds the constraint nobody remembered.

When the record is current, you test the idea during the workshop. Pick the change, and the record shows every place it would touch — before anyone opens a ticket. Try it here.

PR_HIGH_VALUE · proposal
Raise the threshold to

PR_HIGH_VALUE.threshold = 10000 25000

Purchase request workflow · step 3 routing conditionwill update

Document “Approval rules and thresholds” · section 4will update

Training guide · chapter 2 worked examplewill update

PR_STANDARD · not affected

The record marks places this proposal would change.

In the product, this runs on your own configuration

Impact analysis

See what a release touches before it ships.

Release notes written by hand list what people remember changing. The gap between that list and reality is where incidents come from.

A living record compares two environments or two versions field by field and marks every difference in the margin. You review the release against facts — and the same comparison becomes the audit trail afterwards.

Approval rules · v4.1 → v4.2 1 change
PR_STANDARD.threshold€10,000
Changed: PR_HIGH_VALUE.approverwas Purchasing manager now Head of Procurement
PR_HIGH_VALUE.notificationRequester, on approval

This change updates 2 documents and 1 training section automatically.

Comparison of versions 4.1 and 4.2

Support

From “it worked last month” to the cause, in minutes.

Half of troubleshooting is reconstructing what the system looked like when it still worked. Without a record, that means screenshots, old emails and guesswork.

With one, the current configuration is a search away and every previous version sits next to it. The question is no longer “what might have changed?” but “here is what changed — is that it?”

Support · ticket 4718
  • 09:12“A purchase request above €10,000 is stuck at approval. It worked in September.”
  • 09:14Search the record: PR_HIGH_VALUE
  • 09:15v4.2 shows the cause: the approver changed on 21 October — Purchasing manager → Head of Procurement
  • 09:18Answer sent, citing approval_rules.PR_HIGH_VALUE · v4.2 · PROD

Smart documentation

A record you can navigate, search and ask.

A current record earns one more upgrade: it stops behaving like a file and starts behaving like a product. It is structured, so you browse by object instead of scrolling a PDF. It is indexed, so search lands on the field, not the chapter.

And you can ask it questions in plain language. Every answer cites the exact field and version it comes from — verifiable on the spot, never on trust.

Who approves purchase requests above €10,000?

Requests above €10,000 follow the PR_HIGH_VALUE rule and are approved by the Head of Procurement. [1]

  1. [1] approval_rules.PR_HIGH_VALUE · v4.2 · PROD

Method

Read-only. Configuration only. Reproducible.

Docuvara reads the configuration of your environments — production, pre-production, UAT or any other — and writes documentation that matches each one: versioned, traceable, regenerated after every change. It reads configuration metadata only — never transactions, suppliers' data or prices paid.

See it on your own configuration.

A 30-minute demo on a real environment, or start from the sample document.

Choose which cookies we may use. Essential cookies are always on: the site does not work without them.