[csswg-drafts] Issue Title: [css-display] Proposal: Rename section on none and contents to "Box Suppression" (#12461)

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

== Issue Title: [css-display] Proposal: Rename section on none and contents to "Box Suppression" ==
**URL:** https://www.w3.org/TR/css-display-3/

**Section:** Chapter 2: Box Generation: the none and contents keywords

**Issue Description:**
This issue proposes a small but significant terminology change to the CSS Display Module specification for better clarity and intuitiveness.

The current heading for the section covering the display keywords none and contents refers to "Box Generation". However, the fundamental purpose of both of these keywords is to prevent or inhibit the normal box generation process, not to generate boxes. This makes the current title feel counter-intuitive.

**Reasoning:**
The function of these keywords is better described as a form of suppression:

- display: none: This value ensures that the element and all of its descendants generate **no boxes at all**. Its entire effect is the complete prevention—or **suppression**—of box generation for its subtree.
- display: contents: This value causes the element itself to generate no principal box, effectively removing it from the box tree and "promoting" its children to take its place. The primary action is the **suppression** of the element's own box, altering the structure that would otherwise have been generated.

In both cases, the core behavior is the removal, prevention, or inhibition of boxes that would normally be created. The term "Box Generation" is therefore misleading, as it describes the opposite of what these values accomplish.

**Proposed Solution:**
I propose that the title of this section be changed to more accurately reflect the function of these keywords.

**Current Title:** "Box Generation: the none and contents keywords"
**Proposed Title:** "Box Suppression: the none and contents keywords"

**Benefits of this Change:**

- **Improved Clarity:** "**Box Suppression**" immediately and accurately communicates the purpose of none and contents.
- **Reduced Confusion:** For developers and implementers reading the specification, this change would eliminate a potential point of confusion, making the document easier to understand.
- **Better Alignment:** The proposed term aligns directly with the defined behavior of these properties, strengthening the internal consistency of the specification's language.

Thank you for your consideration.



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


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

Received on Tuesday, 8 July 2025 11:55:50 UTC