Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

editorial: Reorganize internal slots into different sections #156

Merged
merged 1 commit into from
Jul 22, 2024

Conversation

rakuco
Copy link
Member

@rakuco rakuco commented Jul 22, 2024

In #152, it was reported that the [[PostureOverride]] slot was confusing, and readers could end up thinking that its null value could be exposed to script, which is not the case (this internal slot is only used internally in calculations that result in a DevicePostureType).

To avoid confusion:

  • Rename the "Internal slots" section to "Extensions to the Document interface", which is similar to what we already have for the Navigator interface.
  • Move the [[PostureOverride]] slot's definition and the addition of internal slots to top-level traversables to the Automation section, and add a sentence explaining the values are not exposed to script directly.

While here, do some proof-reading in the "Extensions to the Document interface" section.

Fixes #152


Preview | Diff

In w3c#152, it was reported that the `[[PostureOverride]]` slot was confusing,
and readers could end up thinking that its `null` value could be exposed to
script, which is not the case (this internal slot is only used internally in
calculations that result in a DevicePostureType).

To avoid confusion:
- Rename the "Internal slots" section to "Extensions to the Document
  interface", which is similar to what we already have for the Navigator
  interface.
- Move the `[[PostureOverride]]` slot's definition and the addition of
  internal slots to top-level traversables to the Automation section, and
  add a sentence explaining the values are not exposed to script directly.

While here, do some proof-reading in the "Extensions to the Document
interface" section.

Fixes w3c#152
@rakuco rakuco requested a review from darktears July 22, 2024 13:39
@darktears
Copy link
Contributor

This is great! LGTM

@rakuco rakuco merged commit 1c1a2bd into w3c:gh-pages Jul 22, 2024
2 checks passed
@rakuco rakuco deleted the reorganize-internal-slots branch July 22, 2024 13:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Clarify that null is never exposed to the page
2 participants