Skip to content

List-like descriptions do not appear in table-of-contents ("In this Article"-nav) #44343

@maritaria

Description

@maritaria

MDN URL

https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/rel#search

What specific section or headline is this issue about?

"In this Article"

What information was incorrect, unhelpful, or incomplete?

Incomplete, the table-of-contents of the article ("In this article" top-right sticky under site header).

On various pages, notably where properties or elements support various values, and those values are listed with descriptions, the list of values is not supported in the table-of-contents.

Sometimes this breakdown occurs as a table, but sometimes more akin to a bullet-list.
In the article for rel= attribute, the possible values are a list. And for convenience of navigation the list items even have a hash anchor (demonstrated in the given link as well). So clearly the item is important enough for external linkage, but this is not structurally supported within the article/mdn itself.

What did you expect to see?

In the navigation, besides the headings, additional (sub) sections should appear when multiple topics are covered within.
Some key use-cases:

  1. For pages that detail possible values of an enumeration, each value should appear in ToC.
  2. For javascript function pages, the "arguments" and "return value" should appear in ToC, preferably each argument as well.

Generally, if something is hash-anchored, consider its inclusion into ToC as it can be linked to anyway.

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

Some example pages, with links to anchors that are not in ToC:

Do you have anything more you want to share?

Currently I need to use browser search in order to efficiently navigate MDN, especially if what I'm looking for is not above the fold.

MDN metadata

Page report details

Metadata

Metadata

Assignees

No one assigned

    Labels

    Content:HTMLHypertext Markup Language docsContent:JSJavaScript docsneeds triageTriage needed by staff and/or partners. Automatically applied when an issue is opened.

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions