From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-0.0 required=5.0 tests=T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 26195 invoked from network); 6 Jul 2022 16:34:33 -0000 Received: from bsd.lv (HELO mandoc.bsd.lv) (66.111.2.12) by inbox.vuxu.org with ESMTPUTF8; 6 Jul 2022 16:34:33 -0000 Received: from fantadrom.bsd.lv (localhost [127.0.0.1]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 51bd3feb for ; Wed, 6 Jul 2022 11:34:31 -0500 (EST) Received: from scc-mailout-kit-02.scc.kit.edu (scc-mailout-kit-02.scc.kit.edu [129.13.231.82]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 9f7c15b9 for ; Wed, 6 Jul 2022 11:34:30 -0500 (EST) Received: from hekate.asta.kit.edu ([2a00:1398:5:f401::77]) by scc-mailout-kit-02.scc.kit.edu with esmtps (TLS1.3:ECDHE_SECP256R1__RSA_PSS_RSAE_SHA256__AES_256_GCM:256) (envelope-from ) id 1o97yv-00HNnT-51; Wed, 06 Jul 2022 18:34:29 +0200 Received: from login-1.asta.kit.edu ([2a00:1398:5:f400::72]) by hekate.asta.kit.edu with esmtp (Exim 4.94.2) (envelope-from ) id 1o97yt-006LR3-GP; Wed, 06 Jul 2022 18:34:27 +0200 Received: from schwarze by login-1.asta.kit.edu with local (Exim 4.92) (envelope-from ) id 1o97yt-0000ZY-Sx; Wed, 06 Jul 2022 18:34:27 +0200 Date: Wed, 6 Jul 2022 18:34:27 +0200 From: Ingo Schwarze To: "J. Lewis Muir" Cc: tech@mandoc.bsd.lv Subject: Re: patch: avoid multiple

Message-ID: References: <20220706144020.hkwn7vrxadhtz3xu@mail.imca-cat.org> X-Mailinglist: mandoc-tech Reply-To: tech@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20220706144020.hkwn7vrxadhtz3xu@mail.imca-cat.org> Hi Lewis, J. Lewis Muir wrote on Wed, Jul 06, 2022 at 09:40:20AM -0500: > 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

per page or view. It should concisely describe the > overall purpose of the content. > > and > > Using more than one

is allowed by the HTML specification, but is > not considered a best practice. Using only one

is beneficial for > screen reader users. > > The HTML specification includes the concept of an outline formed > by the use of
elements. If this were implemented it > would enable the use of multiple

elements, giving user > agents--including screen readers--a way to understand that an

> 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. Thank you for that additional pointer, it's quite interesting and led me to a few facts i did not yet know. The most important takeaway probably is that what i committed is very likely reasonable, as also confirmed by Anna. One thing i didn't understand before following your pointer is that wrapping

inside nested
elements is particularly bad because browsers do not support it. What mandoc -T html did before my commit wasn't quite as bad as that because at least all the

elements were on the same outline level, and all the headings on the lower level used

. Yours, Ingo -- To unsubscribe send an email to tech+unsubscribe@mandoc.bsd.lv