Yellow Theme

Next start · November 2026

Notes / 21

2026-09-17

Reading Mode dropped the FAQ answers

We shipped an FAQ that looked fine on the marketing page. Safari Reader Mode showed the section title and almost nothing else. The answers had lived inside buttons and a list with no markers.

Thesis: Copy that exists only inside a <button> or a list left at Tailwind’s list-style: none does not survive Reader Mode. Questions need real headings. Content lists need .yt-prose-list.

What we shipped first

The FAQ accordion put the full question and answer in the control. A second block used a bare <ul> that inherited list-style none. On the painted page it looked complete. In Reader Mode the extract dropped the button text and the unstyled list items. Prospects who used reading tools saw a blank Answers section.

The working shape

Put each question in an h3. Keep the answer in a paragraph or a .yt-prose-list. The chevron may stay a button with an aria-label — it must not be the only place the words live.

Checklist

Try the lab

Same loop as a small repo: read the tree, run the failing reader check, patch the FAQ markup, re-run until it is green. New here? Type help. Stuck? help next.

Full page: Open this lab · All labs

Related: late font faces must be optional. How we deliver: methodology · readiness.

Engineering commentary only — not audit, legal, or certification advice.