Resolve inconsistent use of headers #680
Labels
accessibility
Relates to accessibility.
bug
Something is broken.
markup
Issues with the use of markup.
For screen readers, LaTeX and EPUB, and many other ways to read the book that aren’t simply a live website, it is important that headers are used consistently, i.e., starting at h1 and increasing by one header level at a time.
Our current convention always uses h4 for exercises, which leads to inconsistent increases, often jumping from h2 to h4.
If there’s no current use of h3, we could simply lift all exercises. Otherwise, we may have to find another way of marking exercises, without using headers—at least in the generated HTML.
If we need to systematically rewrite these, we can rely on—and codify—the convention that “#### Exercise” is always used for exercises.
The text was updated successfully, but these errors were encountered: