Skip to content

Rename "default display mode" to "applied display mode" - #1215

Merged
marcoscaceres merged 5 commits into
mainfrom
fix-display-mode-terminology
May 7, 2026
Merged

marcoscaceres merged 5 commits into
mainfrom
fix-display-mode-terminology

Conversation

@marcoscaceres

@marcoscaceres marcoscaceres commented Apr 10, 2026 •

Copy link
Copy Markdown
Member

Closes #1024

This change (choose at least one, delete ones that don't apply):

  • Makes editorial changes (changes informative sections, or changes normative sections without changing behavior)

Commit message:

editorial: rename "default display mode" to "applied display mode"

The term "default" implied a fallback, when it actually meant the display mode
currently in effect. This rename clarifies the three roles: the manifest's
display member declares the preferred display mode, the UA determines the
applied display mode (via the fallback chain and user/UA overrides), and the
display-mode media feature reflects the applied one.

Also fixes the [=applies=] cross-reference so the subject is the manifest
(matching the dfn at #applying), and corrects the security override example
from "another origin" to "out of scope" for consistency with the rest of the
spec.


Preview | Diff

Closes #1024.

The term "default" implied a fallback, when it actually meant the
display mode currently in effect. This rename clarifies the three
roles: the manifest declares a preferred display mode, the UA
determines the applied display mode, and the display-mode media
feature reflects the applied one.

Also fixes the [=applies=] link so the subject is the manifest
(matching the dfn at #applying), and corrects the security example
from "another origin" to "out of scope" for consistency with the
rest of the spec.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Renames the spec term “default display mode” to “applied display mode” to better reflect that it’s the display mode currently in effect after UA choice/overrides.

Changes:

  • Replaces “default display mode” with “applied display mode” in the display mode section.
  • Updates related prose around manifest application and security override example wording.
  • Tweaks the display-mode media feature sentence to reference the new term.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread index.html Outdated
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@christianliebel christianliebel left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This is different now from what @dmurph suggested, but it would work for me as well.

@marcoscaceres

Copy link
Copy Markdown
Member Author

@dmurph, do you want to give this another look?

Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
- Remove tautology: "resulting X becomes X" → "X in effect is the"
- Remove redundant parenthetical that restated the definition
- "MAY override" → "MAY change" (override conflicts with "applied" semantics)
- Use defined term in note: "actual display mode being applied" → linked term
Convert <a>display mode</a> and <a>applied display mode</a>
to [=display mode=] and [=applied display mode=] shorthand,
consistent with the rest of the spec's linking style.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread index.html Outdated
@marcoscaceres
marcoscaceres merged commit 5cd886a into main May 7, 2026
2 checks passed
github-actions Bot added a commit that referenced this pull request May 7, 2026
SHA: 5cd886a
Reason: push, by marcoscaceres

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@marcoscaceres marcoscaceres added the TPAC2026 Proposed for discussion at TPAC 2026 (Dublin) label Sep 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

TPAC2026 Proposed for discussion at TPAC 2026 (Dublin)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

"Default display mode" section is super confusing

4 participants