In this page

What is documentation debt?
The cost of documentation debt
What the Documentation Debt Audit involves
What you have at the end
Documentation Debt Audit or RAG Readiness Audit — which one do you need?
Who this is for?
Audit scope options
Stop managing the symptoms. Find the cause.

The Documentation Debt Audit

Most organisations already know their documentation isn’t in good shape.

What they don’t know is which parts of it are quietly costing them the most: in support tickets, in developer abandonment, in compliance risk, in onboarding delay, in AI tools that give wrong answers etc.

The Documentation Debt Audit tells you.

What is documentation debt?

Documentation debt is the accumulated cost of documentation that has been deferred, neglected, or outpaced by the product it describes. It builds up the same way technical debt does: gradually, invisibly, until one day the cost of ignoring it exceeds the cost of fixing it.

How documentation debt accumulates

It typically happens because:

A feature ships without documentation because the deadline didn’t allow for it
A procedure is updated in practice, but not on paper
An API endpoint changes but the reference docs don’t
A knowledge base article gets 200 views a month but hasn’t been reviewed since 2022
Documentation lives in four different systems and no one knows which version is authoritative
The person who knew how the legacy module worked left 18 months ago

None of these failures is dramatic. Each one is minor. But together they create a documentation estate that your users, developers, support team, and AI tools can’t rely on. Your organisation is paying for these invisibly, every day.

The cost of documentation debt

Documentation debt doesn’t announce itself. It shows up as other things:

Support tickets for questions the documentation should have answered

When users can’t find accurate, current answers, they raise tickets. A well-maintained knowledge base can deflect 40–60% of support queries. Documentation debt eliminates that deflection.

Developer adoption that stalls

A developer who hits an outdated API reference, a broken example, or a missing authentication guide doesn’t open a ticket. They evaluate a competitor. By the time you find out, the deal is gone.

Onboarding that takes weeks instead of days

New users, new hires, and new customers navigate by your documentation. When it contradicts itself, leads to dead ends, or describes a product version from two years ago, onboarding drag is the result.

AI assistants that give wrong answers

Your AI support tool, internal assistant, or intelligent search is retrieving content from your documentation. If that content is outdated, inconsistent, or poorly structured, the AI will answer confidently and incorrectly. The better your AI tool, the more authoritative its wrong answers will sound.

Compliance exposure

Policies and procedures that are out of date represent a genuine regulatory and operational risk. This is more than for AI Act compliance, but also for ISO standards, sector-specific regulation, and internal audit.

Prospects who evaluate and walk away.

Eighty per cent of decision-makers review documentation before buying. Documentation debt shows during that evaluation. It doesn’t look like “needs some work.” It looks like “this company doesn’t care about its customers.”

What the Documentation Debt Audit involves

The audit is a structured, independent assessment of your documentation. It is carried out by Cherryleaf’s senior technical writers, who know what good documentation looks like and have spent over 20 years identifying why good intentions produce bad documentation.

We don’t just tell you your docs are out of date. We tell you which ones, why it matters, what it’s costing you, and what to do first.

The five-stage process

Stage 1: Discovery call (60 minutes)

We talk with you to understand your documentation landscape: what you have, where it lives, who maintains it (if anyone), and what problems you’re already aware of. We agree the scope and confirm which audit tier fits your situation.

Stage 2: Documentation inventory and sampling

We map your existing documentation against its stated purpose, its audience, and its coverage of your current product or service. For larger estates, we work from a structured sample designed to be representative rather than exhaustive.

Stage 3: Assessment against the debt framework

We assess your documentation across multiple dimensions:

Accuracy
- Does the content reflect the current state of the product, process, or policy?
Currency
- When was it last reviewed? Is there a review process, and is it being followed?
Completeness
- Are there gaps in coverage that users or developers are likely to notice?
Findability
- Can the right person find the right content when they need it?
Consistency
- Does the documentation speak with one voice, use consistent terminology, and give consistent guidance?
AI readiness
- Is the content structured in a way that AI tools can retrieve and use reliably?
- This dimension is included as standard; for teams with an imminent AI deployment, we recommend following the audit with a dedicated RAG Readiness Audit.

Stage 4: Prioritised findings report

You receive a written report that includes:

An overall documentation debt score across the six dimensions
The highest-priority debt items; the ones costing you the most right now
A classification of debt by type: accuracy debt, coverage debt, structural debt, governance debt
A prioritised remediation roadmap: what to fix first, what to fix next, and what can wait
An honest assessment of the governance gap; what process changes would prevent debt from accumulating again
A rough effort estimate for each remediation action, so you can make informed resource decisions

Stage 5: Findings walkthrough (60 minutes)

We present the findings to you and your team, answer questions, and help you build a practical plan for what happens next, whether that’s internal remediation, a writing engagement with Cherryleaf, or a phased programme.

What you have at the end

You’ll receive:

A clear, honest assessment of where your documentation stands
A prioritised list of the highest-cost debt items
A remediation roadmap organised by effort and impact
A governance framework: what would need to change to stop the debt accumulating again
A reusable documentation quality framework your team can apply going forward
A shared language for talking about documentation debt with stakeholders who currently think of it as “a writing problem”

Documentation Debt Audit or RAG Readiness Audit: which one do you need?

Documentation Debt Audit

Primary question: What’s wrong with our documentation, and what’s it costing us?
Trigger: We know our docs have problems but don’t know where to start
Scope: Accuracy, currency, completeness, findability, consistency, AI readiness
Outputs: Broad prioritised remediation roadmap
Best followed by: Writing engagement, restructuring project, or RAG Readiness Audit

RAG Readiness Audit

Primary question: Is our documentation structured correctly for AI retrieval?
Trigger: We’re deploying an AI tool and need to know if our content is ready
Scope: AI retrievability, chunking, structure, metadata, content gaps for AI
Outputs: Specific remediation plan focused on AI readiness
Best followed by: Writing or restructuring engagement to implement recommendations

If you're not sure which one applies to you

These are complementary services, rather than competing ones.

The Documentation Debt Audit is usually the right starting point. It includes an AI readiness dimension as standard.

If the findings reveal that AI readiness is the most urgent priority, we’ll tell you so. The audit cost is credited against a subsequent RAG Readiness Audit.

Who this is for?

This audit is right for you if:

You know your documentation has problems but don’t know which ones are costing you the most
Your support team is fielding questions that should be answered by documentation
You’ve recently launched a product, API, or major update and the documentation hasn’t kept pace
You’re planning to consolidate or migrate your documentation and want to know what’s worth keeping
You’re deploying an AI tool and want to understand the full state of your content before the RAG Readiness Audit
A prospect or client has commented negatively on your documentation
Your documentation team has changed, shrunk, or been restructured and you’ve lost track of what exists and what’s current
Leadership has asked you to “sort out the documentation” and you need an external assessment to define the problem and make the case for resource

Audit scope options

Focused audit

For single content area, up to 50 documents or articles.

Covers one documentation type: a knowledge base, a set of policies and procedures, an API reference, or an in-app help system.

Delivers a prioritised findings report and a 60-minute walkthrough.

Best for teams with a specific, contained documentation problem.

From £1,500 ex VAT

Standard audit

Broader scope, up to 150 documents across up to three content areas.

Covers multiple documentation types. For example: a customer knowledge base, a set of internal procedures, and an API reference.

Delivers a full cross-estate assessment with pattern analysis, a debt classification breakdown, and a phased remediation roadmap.

From £2,800 ex VAT

Comprehensive audit

For larger or complex documentation estates.

For organisations with a large or complex documentation landscape: multiple products, multiple audiences, legacy content in multiple systems, or significant governance issues.

Scope, timeline, and price agreed at discovery.

From £5,000 ex VAT

All tiers include the discovery call, the findings report, and the 60-minute walkthrough. The scoping call is free.

Stop managing the symptoms, find the cause

Most documentation problems are treated as writing problems. The real problem is usually a debt problem: accumulated gaps, outdated content, and absent governance that no amount of individual article fixes will solve.

The Documentation Debt Audit gives you the full picture in a few weeks: what’s wrong, what it’s costing you, and what to fix first.

Book a free scoping call

The scoping call is free and takes 60 minutes. We’ll confirm which audit tier fits your situation and give you a written proposal within a few days.