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: Added definition of "host language" #2261

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

skeetergraphics
Copy link

@skeetergraphics skeetergraphics commented Jun 27, 2024

Closes #2035

Used existing verbiage to make a definition of "host language" while keeping the content as in tact as possible.


Preview | Diff

Used existing verbiage to make a definition of "host language" while keeping all existing content in tact.
Copy link
Contributor

@spectranaut spectranaut left a comment

Choose a reason for hiding this comment

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

One suggestion! :)
And @jnurthen can give advice about exporting definitions, because I'm less familiar with it.

<p>A host language is a markup-based language that either:</p>
<ul>
<li>supports <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr>, using it to augment semantics; or</li>
<li>does not explicitly support <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr>, using it as an accessibility enhancement technology.</li>
Copy link
Contributor

Choose a reason for hiding this comment

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

I feel like this bullet is a little questionable when pulled out of the original paragraph. it's kind of question in the original paragraph to begin with.

Personally, I'd remove the bullets, and say something like what you wrote:

A host language is a markup-based language in which ARIA can be used as an accessibility enhancement technology. Examples include [[HTML]] and [[SVG2]], which both explicitly support the use of ARIA. ARIA roles and properties clarify semantics to assistive technologies...

Copy link
Author

@skeetergraphics skeetergraphics Jul 11, 2024

Choose a reason for hiding this comment

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

I agree with @spectranaut’s direction of removing the bullets and feel we have two slightly different definitions or concepts which the two bullets represented.

If ARIA is well understood as an “accessibility enhancement technology” and if explicitly supporting ARIA is the same as supporting ARIA, this statement may be sufficient:

A host language is a markup-based language that supports the use of ARIA―examples include [[HTML]] and [[SVG2]].

@pkra pkra added the spec:aria label Jul 9, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

"host language attribute" is not defined
3 participants