Inconsistent headings for HTML content categories article

[rami-daoud]

MDN URL

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

What specific section or headline is this issue about?

Headings are not consistent

What information was incorrect, unhelpful, or incomplete?

The writer shows these categories in the beginning of the article:

• Main content categories,
• Form-related content categories,
• Specific content categories

so I expect to see them in H2 as I read forward. but what actually in H2 are

• Main content categories
• Secondary categories
• Transparent content model

What did you expect to see?

• Main content categories
  • Metadata content
  • Flow content
  • Sectioning content
  • Heading content
  • Phrasing content
  • Embedded content
  • Interactive content
• Form-related content categories
  • Form-associated content
  • Labelable elements
  • Submittable elements
  • Resettable elements
• Specific content categories
  • Script-supporting elements
  • Palpable content
  • Transparent content model

Do you have any supporting links, references, or citations?

Do you have anything more you want to share?

MDN metadata

[caugner]

I can confirm the issue. The introduction says:

There are three types of content categories:

• Main content categories, which describe common rules shared by many elements.
• Form-related content categories, which describe rules common to form-related elements.
• Specific content categories, which describe rare categories shared only by a few elements, sometimes only in a specific context.

But two of the three <h2> have deviating titles.

[caugner]

Note that this issue is not trivial to resolve.

Maybe it would make sense to promote some <h3>s to <h2> and remove this initial listing of "three types of content categories", as well as the "Main content categories" h2, because it seems to be a vague meta category.