Re: patch: avoid multiple <h1>

["J. Lewis Muir" <jlmuir@imca-cat.org>]

On 07/06, Ingo Schwarze wrote:
> While the HTML standard explicitely allows documents containing more
> than one <h1>, it contains several examples of header hierarchies,
> and only a single one among these examples contains more than one <h1>.
> That example seems a bit contrived, too.
> 
> Most users expect to find a single <h1> containing the main title
> of the document.  As far as i understand, if there is more than
> one <h1>, that may easily confuse blind users.
> 
> I see no good reason why mandoc should write multiple <h1> headers
> in a single manual page.

Hi, Ingo!

The MDN page at

  https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements

seems to agree with you; in the "Usage notes" section, it says

  Use only one <h1> per page or view.  It should concisely describe the
  overall purpose of the content.

and

  Using more than one <h1> is allowed by the HTML specification, but is
  not considered a best practice.  Using only one <h1> is beneficial for
  screen reader users.

  The HTML specification includes the concept of an outline formed
  by the use of <section> elements.  If this were implemented it
  would enable the use of multiple <h1> elements, giving user
  agents--including screen readers--a way to understand that an <h1>
  nested inside a defined section is a subheading.  This functionality
  has never been implemented; therefore it is important to use your
  headings to describe the outline of your document.

Regards,

Lewis
--
 To unsubscribe send an email to tech+unsubscribe@mandoc.bsd.lv