Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update sectioning content to fit spec #31943

Merged
merged 1 commit into from
Jan 28, 2024
Merged

Update sectioning content to fit spec #31943

merged 1 commit into from
Jan 28, 2024

Conversation

MarcusOtter
Copy link
Contributor

@MarcusOtter MarcusOtter commented Jan 26, 2024

Description

As of whatwg/html#7829, sectioning content no longer defines the scope of heading content. This can also be seen in the spec:

Sectioning content is content that defines the scope of header and footer elements.

Motivation

We should not confuse readers about the fictional Document Outline Algorithm, especially since it is no longer in the spec.

Additional details

whatwg/html#7829
https://html.spec.whatwg.org/multipage/dom.html#sectioning-content-2
https://adrianroselli.com/2016/08/there-is-no-document-outline-algorithm.html

Related issues and pull requests

@MarcusOtter MarcusOtter requested a review from a team as a code owner January 26, 2024 15:41
@MarcusOtter MarcusOtter requested review from estelle and removed request for a team January 26, 2024 15:41
@github-actions github-actions bot added Content:HTML Hypertext Markup Language docs size/xs [PR only] 0-5 LoC changed labels Jan 26, 2024
Copy link
Contributor

@MarcusOtter
Copy link
Contributor Author

MarcusOtter commented Jan 26, 2024

I'm not sure about "Sectioning content [...] creates a section in the current outline [...]" either. Is that correct? It might be, but it's linking to https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements which is kind of confusing. Wasn't sure how to tackle that, happy to hear suggestions on that

Copy link
Member

@estelle estelle left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you! 🎉

@estelle estelle merged commit 8e67368 into mdn:main Jan 28, 2024
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content:HTML Hypertext Markup Language docs size/xs [PR only] 0-5 LoC changed
2 participants