Methodology and Sources
This page explains what the Easy-Read Editor does with your text, where its numbers come from and how the sources of the guides are chosen. The editor's results are estimates. Read them as pointers, not as verdicts.
How the editor reads your text
Everything happens in your browser. No artificial intelligence is used and nothing is sent to a server. The editor follows these steps:
- It splits the text into paragraphs at blank lines.
- It splits each paragraph into sentences. A sentence ends at a period, question mark or exclamation mark followed by a space, or at a line break. Common abbreviations such as "Dr." and "e.g." do not end a sentence.
- It finds the words. A word is a run of letters or digits, and it may contain an apostrophe or a hyphen.
The warnings
| Warning | Rule | Why it is flagged |
|---|---|---|
| Long sentence | More than 25 words | Long sentences make the reader hold many ideas at once. |
| Long word | 12 letters or more. Words with digits are ignored. | A shorter word often says the same thing. |
| Long paragraph | More than 100 words, or more than 6 sentences. Lists are not counted. | Long blocks of text are hard to scan and easy to skip. |
| Repeated word | The same word twice in a row; the same word of four letters or more, other than very common words, three or more times in one sentence; or three or more sentences in a row that start with the same word. | Repetition is often a slip, and a run of sentences with the same opening reads as a drone. |
These limits are common rules of thumb from plain-language advice. They are starting points. A 30-word sentence can read well, and a 10-word sentence can still be confusing. The editor cannot judge meaning.
The reading level estimate
The estimate appears when the text has at least 25 words and two sentences. It uses two published formulas:
- Reading ease = 206.835 − (1.015 × words per sentence) − (84.6 × syllables per word). Higher means easier.
- Grade level = (0.39 × words per sentence) + (11.8 × syllables per word) − 15.59.
| Reading ease score | Label shown |
|---|---|
| 90 to 100 | Very easy |
| 80 to 89 | Easy |
| 70 to 79 | Fairly easy |
| 60 to 69 | Plain |
| 50 to 59 | Fairly difficult |
| 30 to 49 | Difficult |
| 0 to 29 | Very difficult |
Syllables are counted by a simple rule that looks at groups of vowels, so some words are counted wrong. The formulas were made for running prose. Short lists, headings, names and numbers can pull the score up or down. Because the syllable rule is built for one writing system, the estimate can be unreliable for texts in other languages. Treat the score as a rough guide to compare one draft with another.
Display settings and contrast
WCAG 2.2, Success Criterion 1.4.12 says content should keep working when a reader sets line height to at least 1.5 times the font size, spacing after paragraphs to at least 2 times the font size, letter spacing to at least 0.12 times the font size and word spacing to at least 0.16 times the font size. The editor's line spacing and letter spacing sliders reach those values: line spacing goes up to 2.4 and letter spacing up to 0.12 em.
The four contrast themes were checked with the WCAG contrast formula. Success Criterion 1.4.3 asks for a ratio of at least 4.5 to 1 for body text. All four themes are well above that.
| Theme | Text and background | Ratio |
|---|---|---|
| Ivory | #2B2623 on #FFFBF3 | 14.5 to 1 |
| Blue wash | #1B2733 on #DCE9F5 | 12.3 to 1 |
| Night | #FFF6E5 on #1E1B19 | 16.0 to 1 |
| High contrast | #000000 on #FFFFFF | 21 to 1 |
Each warning mark is also drawn with a shape (a bar, dots, a wave or a dashed edge), so it does not depend on color alone.
Where the guides get their facts
Each guide lists its sources at the end. We prefer them in this order:
- Standards and official guidance, such as the Web Content Accessibility Guidelines from the W3C and public plain-language guidance.
- Help pages of browsers and office software, for steps in a given program.
- Research and articles from established usability organizations.
Advice that comes from general craft, for example "split a sentence at the word and", is written as advice and not as a finding.
Before a source is listed, the page is opened and read. The guide then shows the date of that check. We do not list a page we could not open. Pages change, so the date matters: it tells you when the page said what the guide says.
Core sources
- Plain language guide, Digital.gov. The guidelines were earlier published at plainlanguage.gov, which now leads to this page.
- WCAG 2 Overview, W3C Web Accessibility Initiative
- Writing for Web Accessibility, W3C Web Accessibility Initiative
All three were opened and read on November 19, 2026.
Limits
The editor and the guides give general information. They do not check spelling or grammar, they do not prove that a text meets any standard, and they do not replace advice from a professional. See the Disclaimer.