Editorial: Added definition of "host language" #2261
Conversation
Used existing verbiage to make a definition of "host language" while keeping all existing content in tact.
spectranaut
requested review from
spectranaut,
jnurthen,
MelSumner and
cookiecrook
There was a problem hiding this comment.
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> |
There was a problem hiding this comment.
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...
There was a problem hiding this comment.
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]].
There was a problem hiding this comment.
+1 to @spectranaut's rewrite... I don't think the explicit vs implicit support distinction you're making in the original PR text is especially relevant.
|
@skeetergraphics I'm afraid I cannot help rebasing this to the changes on main since it lives on a fork. I hope it won't be too painful. |
spectranaut
moved this to Needs Review
in ARIA Editorial (Spec Prose Updates) PR Tracking
spectranaut
moved this from Needs Review
to Needs update from review
in ARIA Editorial (Spec Prose Updates) PR Tracking
Adds and exports a definition for host language. Also incorporates some of the discussion in #2261.
|
I've opened #2563 which aims to replace this PR. |
jnurthen
added
the
editorial
github-project-automation
bot
moved this from Needs update from review
to Reviewed, need PR checklist item
in ARIA Editorial (Spec Prose Updates) PR Tracking
Closes #2035
Used existing verbiage to make a definition of "host language" while keeping the content as in tact as possible.
Preview | Diff