Knowledge & Memory

Find where your own documents disagree

The contradictions between what you wrote last year and what you tell people now.

Time
11 minutes
You work in
Documents
Connect first
Works out of the box

Before you start

  • A handful of overlapping policies or contracts

Contradictions between your own documents are not a documentation problem. They are a decision that got made twice, differently, and nobody noticed because the two answers live in files that are never open at the same time.

You usually find out when a customer quotes one of them back at you.

Get the overlapping ones in together

You do not need everything. You need the sets that cover the same ground: contracts and the policy that supposedly governs them, the handbook and the onboarding pack, your terms and what your website says.

Upload them into Documents if they are not there already.

Ask directly, and ask for both quotes

Prompt
Read our refunds policy, our standard terms and the two client contracts
in Contracts.

Find anywhere they disagree with each other. For each disagreement, quote
BOTH passages and name both documents, then say plainly what the conflict
is.

Do not report differences in wording that mean the same thing. I want
places where following one document would break the other.

If they are consistent, say so.

The instruction to quote both sides is what makes this usable. A report saying "your notice periods are inconsistent" sends you to read four documents. A report with both sentences side by side lets you decide in thirty seconds which one is right, and that difference decides whether you act on it or file it.

Expect the first run to be noisy

It will flag things that are not really conflicts: an old document that has been superseded, or a general policy and a specific exception that were always meant to differ.

That is fine. Say so, and narrow it:

Prompt
Ignore the 2024 policy, it has been replaced. Client contracts are
allowed to override the standard terms where they say so explicitly. Run it
again with that in mind.

Decide, then fix the loser

The temptation is to reword both documents into something vague enough to cover each case. Resist it.

A contradiction means you have two answers and need one. Pick the one you actually want to be true, then change the other document to match. Vagueness just moves the contradiction somewhere it cannot be found.

Re-run it after anything changes

Once a quarter, or after you have rewritten a policy, which is exactly when new contradictions get introduced.

What good looks like

The first run finds two or three real conflicts, usually including one you have been quietly working around for a year.

The lasting value is the quarterly run. Contradictions are created by editing, so the useful time to look is right after you have edited.