01
Chapter one
The retrieval question that matters
"Produce the procedure as it existed on March 14, 2022." This request arrives routinely in regulated contexts. Whether your document-management program can answer it in thirty seconds determines whether it's defensible.
Every document-management program eventually gets tested against a specific kind of question. An auditor asks about a procedure that was in force on a date two years ago. A litigation discovery request wants the exact version of a policy from the moment an incident occurred. A regulatory inspector asks about a clinical protocol as it existed when a specific patient was treated. A compliance officer preparing for a surveillance visit wants to show the evolution of a particular SOP across its last five revisions.
These are retrieval questions. They don’t ask about the document’s history in the abstract. They ask for a specific historical state.
In passive document-management programs, these questions are disasters in slow motion. The “safety_procedure_v2_FINAL.docx” in the shared drive might be the right version — or it might be a later one that overwrote the earlier state. The version labeled “v2” in a folder dated 2022 might actually be a copy of v3 that someone saved later. The email threads that contained the earlier versions have been purged. The employees who worked on the earlier version have moved on. The reconstruction is at best an informed guess, at worst a fabrication.
30 sec
Typical retrieval time for an exact historical version in an active-lifecycle library. Protocol code + date filter → version.
∞
Default retention for every minor and major version. No automatic pruning. Preservation is the default, not a setting.
2 clicks
From context menu to restored prior version. The revert is itself a new documented event in the audit log.
A retrieval takes seconds; a reconstruction takes days — and sometimes reconstruction is mathematically impossible because the evidence has been overwritten, purged, or never captured.
The distinction between retrieval and reconstruction is the defining difference between an active versioning program and a passive one. Everything else in this guide is the machinery that makes retrieval reliable.
02
Chapter two
Minor versions and major versions
Two version types doing two different jobs — drafting states versus canonical states — with operational consequences that extend to every compliance retrieval.
Active document versioning uses two version types, and understanding why matters for every compliance retrieval downstream.
Minor versions
Drafting states
0.1, 0.2, 0.3 during initial authoring. 1.1, 1.2, 1.3 during revision after publication. Every save creates a new minor version. Captures the full arc of drafting — who changed what, when, with what comments. Invisible to end-users in the public area.
Major versions
Canonical published states
1.0, 2.0, 3.0. Issued only when the approval flow completes. These are the reference points in the audit log, the versions visible to end-users, the ones quoted in compliance retrievals.
Between major version 1.0 (currently published) and major version 2.0 (the next publication), there can be many minor versions — 1.1, 1.2, 1.3, and so on — capturing drafting progress. When 2.0 is approved and published, all the minor versions between are still preserved in the history; they just aren’t visible in the active public area.
Why the distinction matters for audits. When an audit asks “what was the approved version of this SOP on March 14, 2022?”, the answer is always a major version. “Version 2.0, approved on March 2 and in force until September 14 when 3.0 replaced it” is a clean answer. Without the minor/major distinction, the audit log would contain entries for every draft save — hundreds of events per document — and separating “published” states from “drafting” states would require inference.
Every save is a minor version
Word Online auto-saves as the author types. Each save is captured. Co-authoring sessions generate minor versions naturally as multiple people edit. The history reconstructs the drafting sequence.
Major version at flow completion
When the final approver signs off, the system issues the next major version (e.g., 1.x → 2.0). This is the only way a major version gets created — there's no manual "save as major" operation.
Only majors reach end-users
The public area shows only the current major version's PDF. End-users cannot see minor versions. This is structural — they don't have permission to view the editing area at all.
Next cycle starts with 2.1
After 2.0 publishes, revisions start accumulating as 2.1, 2.2, 2.3. When that cycle's approval completes, the system issues 3.0. And so on.
03
Chapter three
How SharePoint's native versioning works underneath
The active-lifecycle product doesn't reimplement versioning — it uses SharePoint's native engine directly. What that means for reliability, interoperability, and your IT footprint.
SharePoint Online has had versioning since the earliest releases of the platform. Every document library can be configured to preserve minor and major versions, handle conflict resolution during co-authoring, and maintain full history. Microsoft has been refining this for over two decades. It’s one of the most battle-tested version-control engines in enterprise software.
The active-lifecycle product uses SharePoint’s native versioning directly. We don’t replace it with a proprietary version engine. What we add on top is the policy layer — the rules about when minor versus major versions get issued, who can revert, what gets captured in the audit log beyond the raw version event, how archival integrates with version lifecycle.
SharePoint provides
Version storage, co-authoring conflict resolution, file-level diff tracking, version-history UI, API access, retention-policy engine, search indexing of all versions.
The product adds
Minor-to-major transition logic (via approval flow), audit log that captures versioning in context, archival transition on new major publish, version-aware expiration reminders, Power BI aggregation across versioning data.
Microsoft's engine
The versioning substrate has 25+ years of production operation at scale. It's the same engine that handles version history for millions of SharePoint libraries across Microsoft's cloud tenants. The active-lifecycle product inherits that reliability.
Version data stays in your tenant
Every version — minor and major — is stored in SharePoint inside your Microsoft 365 tenant. No version data goes to a SaaS provider's cloud and comes back. For regulated data-residency constraints this is structural.
The practical consequence of building on SharePoint’s versioning rather than a proprietary one: version data survives. If the customer stops using the active-lifecycle product, the versioning doesn’t disappear — it remains in SharePoint libraries where it was stored, accessible through Microsoft’s native tools. This is a meaningful property for long-term regulated records, which may need to be retrievable for decades.
04
Chapter four
Revert — recovering from mistakes
Every prior version is revertible. The revert itself becomes a new documented version. Mistakes become part of the history, not erasures of it.
Documents accumulate errors over time. Somebody deletes a section that turns out to have been important. A revision changes the wrong paragraph. A late-stage edit introduces an inconsistency. In passive document systems, the response to these errors is usually panic, followed by manual reconstruction from somebody’s local copy or an old email attachment.
In an active versioning system, the response is two clicks.
1
Step one
Discover the error
Someone notices the deleted section is missing. A reviewer catches the wrong-paragraph edit. The author realizes a revision broke internal consistency. The context menu for the document exposes "Version history" with a complete list of prior versions.
2
Step two
Preview any prior version
The version-history UI lets the user open any prior version in read-only preview. Verify it contains what you expect. Confirm it's the right state to restore to.
3
Step three
Restore with two clicks
Click "Restore." Confirm. The document content returns to the selected prior version. The restore creates a new minor version containing the restored content. Nothing is deleted — the intervening (erroneous) versions remain in history, just no longer current.
4
Step four
Event written to audit log
The restore itself is captured as a documented event: who restored, from which prior version, to which new minor version, with the timestamp. The audit trail now shows the full sequence: the original version, the erroneous edit, the restore. Nothing is hidden.
The cultural point is worth stating plainly. In passive systems, mistakes create anxiety because they feel permanent; the scramble to find a backup produces secondary errors (wrong version restored, partial recovery, stuff missed). In an active system, mistakes are inconvenient but cheap. The psychological effect on authors is noticeable — they take more risks, make more changes, catch more issues — because they know every state is recoverable.
Reversibility changes behavior. When every change is recoverable, authors edit more freely and catch more issues. When every change feels permanent, they edit defensively and miss things.
05
Chapter five
Version policy — a customer decision
What counts as a major change versus a minor one is organizational choice, not product mandate. The product supports either pattern — the compliance work is documenting the choice and applying it consistently.
Compliance frameworks generally don’t prescribe what makes a change major versus minor. They expect the organization to have a documented policy and to apply it consistently. This means versioning policy is a deliberate choice, not a default setting.
Pattern A
Major = published
The default in our product. Major versions are what the approval flow produces. Minor versions are drafting states only. Every publication is a major version. Simple, clear, easy to explain to auditors.
Pattern B
Major = material change
Some organizations reserve major versions for substantive content changes. A typographic fix that's approved and published might stay at 2.1 rather than becoming 3.0. Requires a documented definition of "material." Can be accommodated but adds policy complexity.
Pattern A is what most customers choose because it’s simpler to explain during an audit. “Every published version is a major version” is a policy auditors immediately understand. Pattern B adds nuance for organizations where the distinction matters — for instance, where frequent typographic corrections would otherwise create version inflation — but requires the customer’s Quality or Compliance team to define and document what “material” means.
The product accommodates either choice. What it enforces is consistency: once the policy is defined, it applies across the document type. Different document types can use different policies if the organization finds that useful.
A practical note on version numbering. Some organizations have historical policies like “SOPs use whole-number major versions (1.0, 2.0, 3.0); policies use decimal major versions (1.00, 1.01, 1.02).” The product’s display format is configurable per document type but the underlying version engine always uses the major.minor convention. When the display format matters for compliance (e.g., a regulator expects specific notation), that’s a configuration decision during implementation.
06
Chapter six
What the audit log captures about versions
The interaction between versioning and the audit log is what turns raw version history into compliance evidence.
Every significant version event writes to the audit log — not just the fact that a version happened, but enough contextual metadata to answer downstream audit questions without additional queries.
| Event type |
What the log captures |
Why it matters |
| Minor version save |
Author identity, timestamp, version number, any comments. |
Reconstructs the drafting arc. |
| Major version issued |
Approval flow ID, all approver identities and roles, version number, timestamp. |
The primary audit retrieval reference point. |
| Version restore (revert) |
Restorer identity, source version, destination minor version, timestamp, reason if provided. |
Makes reverts transparent — mistakes become history, not hidden. |
| Archive transition |
Superseded major version, superseding major version, timestamp. |
ISO 9001 clause 8.5.3 "control of obsolete documents." |
| Version rollback from archive |
Rarely used: a superseded version is retrieved from archive for audit purposes. Retriever identity, timestamp. |
Evidence of an audit-driven retrieval. |
During audits, the combination of version history and audit log is what makes retrievals possible. The version history shows the content states; the audit log shows who did what to produce those states, in what capacity, when. The two together produce a complete reconstruction of the document’s lifecycle that no reasonable auditor can challenge.
07
Chapter seven
Litigation holds and preservation
Legal-hold obligations extend beyond normal retention. Active versioning makes hold compliance straightforward; passive systems make it nearly impossible.
When litigation is anticipated or underway, documents relevant to the legal matter become subject to preservation obligations. Normal retention policies are suspended; the organization must preserve all versions of the relevant documents until the hold is lifted. Failure to preserve (spoliation) can result in adverse inferences, sanctions, or worse.
Passive document systems make litigation holds operationally expensive. The legal team has to identify every location where relevant documents might exist (shared drives, SharePoint libraries, personal drives, email attachments, backup tapes), communicate the hold to every document custodian, and hope that nothing gets accidentally deleted during the hold period. In practice, mistakes happen — and in litigation, those mistakes are visible.
Scope the hold
Search by protocol code, metadata, or full-text content to identify all documents potentially relevant. The filter results are the hold scope.
Apply hold metadata
Tag documents as "under hold" via metadata. The metadata tag suspends automatic archival or deletion for those documents regardless of normal retention rules.
All versions preserved
Every minor and major version of held documents is preserved automatically. New versions continue to be captured during the hold period — nothing stops normal authoring, but nothing gets lost either.
Produce on demand
When discovery requests arrive, produce the exact versions required — by protocol code, date range, or content query. The full version history is the responsive production.
Microsoft Purview also supports enterprise-level legal hold with automatic preservation across SharePoint, Exchange, Teams, and OneDrive. Customers with sophisticated legal-ops programs often use Purview hold as the primary mechanism and the active-lifecycle product’s versioning as the content layer that populates what Purview preserves.
08
Chapter eight
Compliance mapping
Which versioning capabilities satisfy which regulatory clauses — specific and precise.
| Regime |
Clause |
Expectation |
| ISO 9001 |
7.5.3 |
Documented information must be controlled, with particular attention to changes and version identification. Minor/major versions satisfy the identification requirement; the audit log satisfies the "changes controlled" requirement. |
| ISO 9001 |
8.5.3 |
Obsolete documents must be controlled to prevent unintended use. Automatic archival on new major publication enforces this structurally. |
| FDA Part 11 |
§11.10(c)(d) |
Protection of records to enable accurate and ready retrieval throughout the retention period; limiting access to authorized individuals. Version preservation + access control on the archive satisfy both. |
| GDPR |
Art. 5(2) |
Accountability — controllers must be able to demonstrate compliance with data-protection principles. Versioning preserves the evidence of compliance posture over time. |
| GDPR |
Art. 5(1)(e) |
Storage limitation — personal data kept no longer than necessary. Version retention policies must be aligned with data-minimization obligations. The customer defines retention; the product preserves within that policy. |
09
Chapter nine
Versioning vs retention — two layers
Versioning preserves history within the document's active life. Retention governs how long documents and their histories are kept at all. Different problems, different tools.
These two layers get confused in customer conversations frequently enough that it’s worth spelling out explicitly.
Versioning
Active-life history
While a document is actively governed — being revised, approved, published — every state is preserved. You can retrieve any minor or major version on demand. This is the product's core capability.
Retention
Records-management policy
How long documents (and their version histories) are kept overall. Could be seven years for financial records, ten years for clinical trials, fifty years for certain construction documents, indefinite for others. Governed by regulation and organizational policy.
Microsoft Purview is the tenant-level retention engine. It applies retention policies across SharePoint, Exchange, Teams, and OneDrive based on classification, location, or content patterns. Customers with established records-management programs typically use Purview retention as the enterprise policy engine, with the active-lifecycle product’s versioning preserving the content that Purview governs.
The two layers interoperate. A document with a seven-year retention policy in Purview has its version history preserved for seven years from the applicable trigger (publication, last modification, legal-hold lift, whatever the policy specifies). Within that seven-year window, the active-lifecycle product provides full version history and retrieval. After the retention window expires, Purview handles the deletion.
One important interaction. The active-lifecycle product’s expiration-reminder mechanism (the one that emails the document owner to re-certify) is not a retention mechanism. Expiration reminders drive review cadence. Retention drives eventual deletion. An expired document whose owner doesn’t re-certify moves to archive but is still preserved per retention policy; it becomes “obsolete and archived” but not “deleted.” The deletion trigger is the retention policy’s end date, applied by Purview, not the expiration reminder.
10
Chapter ten
Implementation — defining your version policy
The four decisions that turn versioning from a feature into an operational practice.
Version-number format
Most customers use major.minor (1.0, 1.1, 2.0). Some regulated contexts want specific formats (1.00, v2.0, etc.). Decide during implementation; stays consistent across document type.
What triggers a major version
Pattern A (approval-driven) or Pattern B (materiality-driven). Document the choice in your Quality Manual. Most customers pick Pattern A.
Who can revert
By default, the document owner and anyone with edit permission can revert. In high-control environments, restrict to Quality team. Every revert is logged either way.
Retention policy per document type
Set via Purview tenant policy, informed by document type (clinical: 25 years, financial: 10, internal procedures: indefinite). The product's versioning preserves within whatever window retention permits.
Once the four decisions are made, they belong in the organization’s documented-information control procedure — itself a document that goes through the approval flow and is version-controlled. The policy becomes its own example of an actively-managed document.
A versioning policy you can explain to an auditor in two minutes is more valuable than a sophisticated one that takes twenty. Choose simplicity.
Versioning is the mechanism that makes every compliance retrieval answerable. Get it right and the audit questions that terrify other organizations become thirty-second retrievals. Get it wrong — treat it as a background technical detail rather than an operational practice — and you discover the cost when the retrieval fails.
A 30-minute conversation with our team is usually enough to walk through your current versioning practice, identify the retrieval scenarios you’re most exposed to, and map a version policy that suits your regulatory environment.