w3c / wcag2ict

WCAG2ICT deliverable of Accessibility Guidelines WG
https://wcag2ict.netlify.app/
Other
19 stars 5 forks source link

Definition of 'style properties' needs different word substitution #419

Closed mitchellevan closed 1 month ago

mitchellevan commented 3 months ago

The definition of 'style properties' has a couple of issues

Issue: "rendered... by user agents or platform software" is correct for non-web documents with embedded markup, but it's not correct for non-web software such as an Electron app, where the software itself (not the underlying platform software) is responsible for the rendering.

Issue: The description of the last replacement isn't correct.

Currently

This applies directly as written and as described in the WCAG 2 glossary, replacing “user agent(s)” with “user agent(s) or platform software”, "web content" with "content", replacing "in-line styles, author style sheets" with "programmatically-set styles", and replacing "user agent interface settings, user style sheets" with "user agent, platform software or other software settings".

With these substitutions, it would read:

style property
property whose value determines the presentation (e.g. font, color, size, location, padding, volume, synthesized speech prosody) of content elements as they are rendered (e.g. onscreen, via loudspeaker, via braille display) by **[[user agents](#user-agent) or [platform software](#platform-software)]** Style properties can have several origins: - **[User agent or platform software]** **default styles:** The default style property values applied in the absence of any author or user styles. Some **[content]** technologies specify a default rendering, others do not; - **Author styles:** Style property values that are set by the author as part of the content (e.g. **[programmatically-set styles]**); - **User styles:** Style property values that are set by the user (e.g. via **[user agent, platform software or other [software](#software)]** interface settings)

Proposed

style property
property whose value determines the presentation (e.g. font, color, size, location, padding, volume, synthesized speech prosody) of content elements as they are rendered (e.g. onscreen, via loudspeaker, via braille display) by **[[user agents](#user-agent) or [software](#software)]** Style properties can have several origins: - **[User agent or platform software]** **default styles:** The default style property values applied in the absence of any author or user styles. Some **[content]** technologies specify a default rendering, others do not; - **Author styles:** Style property values that are set by the author as part of the content (e.g. **[programmatically-set styles]**); - **User styles:** Style property values that are set by the user (e.g. via **[user agent, platform software or other [software](#software) settings]**, user style sheets)
olivia-hogan-stark commented 2 months ago

@maryjom I made a task in the Google Doc for TF to review Mitch's word substitutions.

maryjom commented 1 month ago

The TF reached resolution on 15 August. to make the updates per Mitch's suggested edits and adding another "or" for better readability before "user style sheets". The changes will be merged once an editor has reviewed the PR.

maryjom commented 1 month ago

These changes have been incorporated into the editor's draft. Closing the issue as complete.