[csswg-drafts] [indexes] Index of Terms and Expansions of Productions (#13498)

Crissov has just created a new issue for https://github.com/w3c/csswg-drafts:

== [indexes] Index of Terms and Expansions of Productions ==
The [central index](https://drafts.csswg.org/indexes/) currently provides a tremendously helpful overview of 

- Properties and Descriptors
- Property/Descriptor Values
- Grammar Productions / Types
- Functions
- At-Rules
- Selectors

Each module of CSS includes (or should include) a subsection _Terms defined by this specification_ within its _Index_ section, near the end. Could the central index please also include an overview of those **terms** and where they are defined?

----

Personally, I would also like properties and descriptors (and values thereof) separated at least into sibling subsections, but I know that many people have a hard time distinguishing them or don’t see the need to do so (which shows in the language and choices of some modules even) and I don’t know whether the distinction is made by Bikeshed at all. 
Likewise for pseudo-classes and pseudo-elements in the Selectors section or keywords and productions/types in the Values section, where the latter are all(?) repeated in the following Grammar section anyway. 

----

Frequently, I would also have liked if the index had shown expansions in place or a special variant of the index that only had the Grammar section with expansions `<foo> = bar | <'baz'>` combined with the property value syntaxes `<'baz'>`. 

----

Sometimes, it would have made research easier if the indexes also included dropped features from earlier drafts; properly marked of course, but I suspect that recording the stability status of entries like that (or _at risk_ for instance) goes beyond the purpose and possibilities of an automatically generated index.

Please view or discuss this issue at https://github.com/w3c/csswg-drafts/issues/13498 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Sunday, 15 February 2026 10:24:32 UTC