· 4 min read
How to Keep One Voice Across a Document
Manesh Jayawardhana
CIO & Co-founder
A reader gets four sections into the guide and something changes. The information is still good, the writing is still competent, and they can tell a different person wrote it.
They usually cannot say why, and it costs the document credibility in a way nobody can attribute afterwards.
The three dimensions readers notice
Formality. Contractions or not, “we recommend” against “it is recommended”, hedged or direct. This shifts most obviously between authors and is the easiest to detect.
Person. Second person addressing the reader, first person plural speaking for the organisation, or impersonal third person. A document that switches between “you should”, “we suggest” and “it is advisable” reads as assembled rather than written.
Tense and mood. Instructions in the imperative against the conditional — “click save” against “you would then click save”. Both work; mixing them within one procedure does not.
Each is individually small. Together at a section boundary they are the signature of a change of hands, and readers detect it reliably even when they cannot name it.
| Dimension | Consistent | Drifting |
|---|---|---|
| Formality | “We recommend” throughout | Mixed with “it is recommended” |
| Person | Second person throughout | “You” then “users” then “one” |
| Mood | Imperative instructions | Mixed with conditional |
Deliberate shifts are fine
Not every change is a defect, and treating them all as one produces a flattened document.
A conversational guide with a formal reference appendix is a deliberate structure, and the shift signals to the reader that they are in a different kind of material. Legal or compliance sections often need different language for good reasons. A worked example may reasonably be more informal than the surrounding explanation.
The distinction is whether the shift is at a boundary the reader can see. A change of register at a clearly marked section break reads as intentional. The same change in the middle of a chapter reads as a different author.
That is the useful test when reviewing flagged sections: is there a visible reason for the change at that point?
Fix at boundaries, not everywhere
When a multi-author document drifts, the instinct is to rewrite the whole thing in one voice. That is a large job and usually unnecessary.
Most of the perceived inconsistency comes from transitions. Two sections in slightly different registers read fine if the boundary between them is clean; the same two sections read as jarring if one runs into the other with no signal.
Editing the first and last paragraphs of each section for consistency handles a surprising amount of it, at a fraction of the cost of a full rewrite. Where a full harmonisation is warranted, doing the boundaries first tells you how much more is actually needed.
Write a short style note first
On a multi-author document, an hour of agreement at the start saves a day of harmonisation at the end.
The note does not need to be long. Five or six decisions cover most of what causes drift:
Person — do we address the reader as “you”, or refer to “users”?
Formality — contractions or not.
Instructions — imperative or conditional.
Terminology — one term per concept, listed.
Serial commas, capitalisation of headings, number formatting — small, and endlessly inconsistent without a decision.
Circulated before writing begins, that removes most of the drift at source. Written after the document exists, it becomes a checklist for an edit nobody has time for.
Common mistakes to avoid
- Rewriting an entire document when the boundaries are the problem.
- Treating every register shift as an error, including the deliberate ones.
- Checking a single section, when consistency is by definition a comparison.
- Harmonising voice before the content is settled, since restructuring changes the boundaries.
- Assuming one author means one voice — a document written over six months drifts too.
How to do it with Text Voice Consistency Checker
The Text Voice Consistency Checker compares sections against each other.
- Paste the whole document rather than a section.
- Read the flagged sections and check whether each shift has a visible reason.
- Fix the transitions first — first and last paragraphs of each section.
- Reassess before committing to a full harmonisation.
Other writing tools that keep your text local are in the tools directory.
Frequently asked questions
What causes voice to drift?
Multiple authors, writing sessions weeks apart, and content pasted from other documents. It shows most at section boundaries, which is why comparing sections finds it faster than reading through.
Is a shift in formality always wrong?
No. A conversational guide with a formal appendix is deliberate. What reads badly is a shift with no visible reason at that point, which the reader interprets as a change of author.
Does this rewrite the text?
No. It reports where sections differ and on which dimension. Which voice the document should settle on is an editorial decision.
Final thought
Fix the boundaries before the bodies. Most of what reads as inconsistency is two sections meeting badly rather than two sections being wrong.