Update aria-state-or-property-permitted-5c01ea.md

[ajanec01]

Trying to resolve the issue raised in #1573.

Not exactly sure if this is the right way so would appreciate the input.

Closes issue(s): #1573

Need for Final Call:
1 week

How to Review And Approve

• Go to the “Files changed” tab
• Here you will have the option to leave comments on different lines.
• Once the review is completed, find the “Review changes” button in the top right, select “Approve” (if you are really confident in the rule) or "Request changes" and click “Submit review”.
• Make sure to also review the proposed Final Call period. In case of disagreement, the longer period wins.

[Jym77]

I'm a bit uneasy in leaving "language feature" as it and only explain it in a background note (versus trying to have a definition).
The rule is only targeting HTML and SVG, and I don't think there is a similar "ARIA in SVG" (or other feature document) out there. So maybe we can be a bit more prescriptive here (to make sure and remove the ambiguity). Pointing here to ARIA in HTML and saying that if the target is an HTML element, it may also have stuff described there.

[ajanec01]

Yes, I thought about that too. In the end, I decided to leave the "language feature" for everybody else to decide on it. Yeah, I'm not sure if there ever will be an equivalent concept for SVG so we can tighten it.

[WilcoFiers]

I think you're trying to pack too much information into one sentence. It might be better to break this up into a list:

Suggested change

	Each test target is either an [inherited][], [supported][], or [required][] [state][] or [property][] for the element's [semantic role][] or the [WAI-ARIA state or property][] may be used on the language feature. If the element has no [semantic role][], the attribute must be a [global state or property][global].
	One of the following is true for each test target:
	- **Global**: the test target is a [global state or property][global]; or
	- **Semantic Role**: the test target is an [inherited][], [supported][], or [required][] [state][] or [property][] of the [semantic role][] of the element on which the test target is specified; or
	- **language feature**: the test target is allowed as a language feature on the element on which it is specified. Which ARIA state or property may be used on which element is describe in [ARIA in HTML][].

This will also make it easier to add prohibited attributes when ARIA 1.2 makes it to rec.

[WilcoFiers]

I think you're trying to pack too much information into one sentence. It might be better to break this up into a list:

Suggested change

	Each test target is either an [inherited][], [supported][], or [required][] [state][] or [property][] for the element's [semantic role][] or the [WAI-ARIA state or property][] may be used on the language feature. If the element has no [semantic role][], the attribute must be a [global state or property][global].
	One of the following is true for each test target:
	- **Global**: the test target is a [global state or property][global]; or
	- **Semantic Role**: the test target is an [inherited][], [supported][], or [required][] [state][] or [property][] of the [semantic role][] of the element on which the test target is specified; or
	- **language feature**: the test target is allowed as a language feature on the element on which it is specified. Which ARIA state or property may be used on which element is describe in [ARIA in HTML][].

This will also make it easier to add prohibited attributes when ARIA 1.2 makes it to rec.

Applied almost all suggesstion- only made changes to the last point.

[Jym77]

Looks good 👍

All committed!