From 6682bdeee6fb08f5972bea92064fe250f1b4ec9c Mon Sep 17 00:00:00 2001 From: Steve Faulkner Date: Fri, 1 Jul 2022 05:24:24 +0100 Subject: [PATCH] Replace the outline algorithm with one based on heading levels Removes the idea of sectioning content influencing the document's outline. Instead, the outline is derived from all of the document's h1-h6 elements. (Sectioning content still plays a role in scoping header and footer elements.) This ensures that the outline generated by the outline algorithm, i.e. the document's semantics for authors, better aligns with the way screen reader users navigate through headings and the corresponding normative requirements for implementations in the HTML-AAM specification. Updates the hgroup element to have a new content model, to use p elements for related content such as subheadings, alternative titles, or taglines (instead of using heading elements for those). Updates all of the spec's examples to have proper outlines, according to the new outline algorithm. This includes preferring h2 to h1 in markup fragment cases, so as to better suggest that they are part of a larger document whose outline contains a h1. Closes #83. Closes #3499 by superseding it. Closes #6462 by updating hgroup's suggested usage instead of obsoleting it. See #7867 for potential followup work in avoiding sectioning content and hgroup influencing the style of h1-h6 elements. Co-authored-by: Anne van Kesteren Co-authored-by: Domenic Denicola --- images/outline.svg | 2 +- source | 1242 ++++++++------------------------------------ 2 files changed, 207 insertions(+), 1037 deletions(-) diff --git a/images/outline.svg b/images/outline.svg index e5c66e34684..ffb18d020d7 100644 --- a/images/outline.svg +++ b/images/outline.svg @@ -12,7 +12,7 @@ } ]]> - HTML: Living Standard — Last Updated 12 August 2016 + HTML: Living Standard Table of contents First section diff --git a/source b/source index 4b8d767a8ce..4f9864c34f1 100644 --- a/source +++ b/source @@ -57,10 +57,16 @@

Living Standard — Last Updated [DATE: 01 Jan 1901]

Commit Snapshot — Last Updated [DATE: 01 Jan 1901]

Review Draft — Published [DATE: 01 Jan 1901]

+

HTML: The Living Standard

Edition for Web Developers — Last Updated [DATE: 01 Jan 1901]

+