How to Compare Two Versions of a Text Document
Two versions of the same document and a question: what changed? Reading them side by side finds the paragraph that moved and misses the number that went from 4.5 to 4.6. The Text Diff Checker highlights every difference.
Why reading them is not enough
Human attention is drawn to large differences and slides over small ones. The changes that matter in a contract, a price list or a configuration file are usually small: a digit, a negation, a name, a date.
A diff has no such bias. It compares mechanically and reports everything, which means it finds the single character you would never have spotted - and it also means it reports things you do not care about, which is the skill in reading one.
Noise, and how to get rid of it
The commonest frustration is a diff that marks nearly every line as changed when the text is substantially the same. Three causes, all of them whitespace.
Reflowed paragraphs. If one version wraps its lines at a different width, every line differs even though no word did. Line endings. A file edited on Windows and one edited on a Mac differ invisibly at the end of every line. Trailing spaces, added or removed by whichever editor touched the file last.
Running both sides through the Whitespace Trimmer before comparing removes most of this, and what is left is the real difference. It is worth the extra step: a diff that reports everything reports nothing.
What to look at first
Numbers, negations and names. A changed figure, an inserted or deleted "not", a swapped party name - these are the edits with consequences, and they are the ones a read-through misses.
Then look for deletions rather than additions. New text announces itself; removed text leaves no trace in the new version, and a clause that quietly disappeared is the single most dangerous kind of change in anything you are about to sign.
Where it is most worth doing
A contract returned by the other side, where "a few small changes" deserves verification. Configuration before and after an edit, when something stopped working. Terms and conditions you are being asked to re-accept. And your own draft against your editor's, which is the fastest way to learn what you habitually get wrong.
For structured data rather than prose, the JSON Diff Checker compares meaning rather than characters, which is the right tool for that job.
Common questions
Can it compare two PDFs?
Extract the text from both with the PDF Text Extractor first, then compare. Expect whitespace noise from the extraction.
Does it show moved text as moved?
Usually as a deletion in one place and an addition in another, which is worth knowing so a moved paragraph is not mistaken for a rewrite.
Is my document uploaded?
No. The comparison happens in your browser, which matters for a contract.
How long can the two versions be?
Long documents work; the output simply gets long too. Comparing one section at a time is easier to read.
Got two versions to check?