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:

  1. It splits the text into paragraphs at blank lines.
  2. 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.
  3. It finds the words. A word is a run of letters or digits, and it may contain an apostrophe or a hyphen.

The warnings

WarningRuleWhy it is flagged
Long sentenceMore than 25 wordsLong sentences make the reader hold many ideas at once.
Long word12 letters or more. Words with digits are ignored.A shorter word often says the same thing.
Long paragraphMore 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 wordThe 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 scoreLabel shown
90 to 100Very easy
80 to 89Easy
70 to 79Fairly easy
60 to 69Plain
50 to 59Fairly difficult
30 to 49Difficult
0 to 29Very 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.

ThemeText and backgroundRatio
Ivory#2B2623 on #FFFBF314.5 to 1
Blue wash#1B2733 on #DCE9F512.3 to 1
Night#FFF6E5 on #1E1B1916.0 to 1
High contrast#000000 on #FFFFFF21 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:

  1. Standards and official guidance, such as the Web Content Accessibility Guidelines from the W3C and public plain-language guidance.
  2. Help pages of browsers and office software, for steps in a given program.
  3. 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

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.