- 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
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:
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.