Read only the headings and first sentences
In the DevTools console (
F12, theConsoletab), the page’s plan by headings:[...document.querySelectorAll('main h1, main h2, main h3')] .map((h) => (h.tagName === 'H3' ? ' ' : '') + h.textContent.trim()) .join('\n')You should get a plan that tells you what’s where. “Description, Installation, Other” — rewrite the headings (Headings say what’s inside). The first sentences of paragraphs:
[...document.querySelectorAll('main p')] .map((p) => p.textContent.trim().split(/(?<=[.!?])\s/)[0]) .join('\n\n')If the first sentences retell the substance, the answers are up front. If they’re introductions and connectors instead of content, the answers are buried deeper (Answer first).
Blur the page
document.body.style.filter = 'blur(3px)'The text becomes unreadable and blobs remain. It’s good if you see three levels: large headings, a gray field of text, small captions (Three levels of importance). It’s bad if the first thing to jump out is a banner, a panel or an icon rather than the main thing. Alignment shows too: block edges that should sit on one line, and different spacing on identical blocks. Put it back with
document.body.style.filter = ''.Look at 360 px wide
Ctrl+Shift+Mopens device mode; set width 360, height 800. Check:- no paragraph is longer than the screen, no heading breaks into one word per line;
- tables scroll within themselves or fit;
- edge margins are 16 px or more, and nothing sticks to the edge.
The console shows whether the page slides sideways:
document.documentElement.scrollWidth - innerWidth. Zero or less means it doesn’t:innerWidthincludes the scrollbar, so on a computer you get, say,-15. Above zero — find what’s wider than the screen:[...document.querySelectorAll('body *')] .filter((el) => el.getBoundingClientRect().right > innerWidth + 1) .map((el) => el.tagName + '.' + el.className)The list also includes lines inside code blocks and tables that scroll on their own — skip those and look for the top-level block.
Turn on dark mode and 200% zoom
Ctrl+Shift+P, theShow Renderingcommand; in the panel that opens, setEmulate CSS media feature prefers-color-schemetodark. Look at images, diagrams and shadows: white rectangles and vanished borders show at once.Set it back to
light, leave device mode and zoom to 200% (Ctrl++five times from 100%). Text reflows, isn’t cut off, and the page doesn’t scroll sideways — WCAG 1.4.4 and 1.4.10 are met.Check contrast
The
Lighthousetab in DevTools: keep only theAccessibilitycategory and clickAnalyze page load. In the report, the itemBackground and foreground colors do not have a sufficient contrast ratiolists elements below the threshold. No such item means text contrast passes 4.5:1, and 3:1 for large text. For a single element, use the color picker in Styles, theContrast ratioline (Text contrast).The report checks the page in one theme; in the other, check the body text and captions with the picker.
Show the first screen for five seconds
Show the first screen to someone who hasn’t seen the page for 5 s, then close it. Ask: what is the page about, and what can you do on it? If they say in their own words what you meant to say, the first screen works (One screen, one idea). If they name a banner, an image or “something about settings”, the main thing on the first screen doesn’t look like the main thing.
No one around — ask yourself the same a day later: a day is enough to forget the text and see it from the outside.
How to check
The check of the checks is the same page a week later: the questions people asked about it should be answered by the headings from step 1. A question whose answer is there but wasn’t found is the first candidate for an edit (Scannable text).
If it doesn’t work
The console’s heading list is empty, though the page shows headings
- Cause
- The headings are
divs with a large font. The eye sees them; search, screen readers and the table of contents don’t. - Fix
- Use
h2andh3tags for headings; set the size with styles, not by choosing a tag.
On a phone the page slides sideways
- Cause
- Something is wider than the screen: a table, a code block without scrolling, an image with a pixel
width. - Fix
- Find the culprit in the console (step 3); give tables and code their own scrolling with
overflow-x: auto, and imagesmax-width: 100%.
In dark mode some images are white rectangles
- Cause
- Diagrams and screenshots with white backgrounds, saved for the light theme.
- Fix
- Diagrams as SVG with theme-variable colors or a transparent background; screenshots in a frame so the white field reads as an image.