Headings

labels, not questions

A reader scans headings to find the one holding their answer, so a heading is a label on a drawer.^[1] The check refuses the three kinds of heading that name nothing.^[1]

Questions

A heading that opens with how, what, where, why, when, which, who or whether is refused.^[2] Such a heading is the writer wondering what belongs in the section, when the reader wanted the name of the answer: "Where it lives" should be Home.^[2] A word that merely starts the same way, such as "However", passes.^[2]

Verdicts

A heading that rates its own contents is refused: any heading containing matter, important, interesting, note, overview, misc or detail, anywhere in it.^[3]

Words are matched whole, and only matter and detail are also matched in the plural.^[3] "A note on dates" is refused, but "Release notes" passes.^[3]

Pointers

A heading that opens with this, that, these, those, our or here is refused.^[4] It points at the page it sits on instead of naming anything, so "Our setup" should be Setup.^[4] A title or an infobox label that opens the same way is refused as well, as described on Pointing words.

Scope

Every heading from the second level to the sixth is checked.^[5] The page title is held only to the pointing words, described on Pointing words. A line inside a code sample is not a heading, and is not checked.^[5]