Characteristics of Roles section needs tidying up #1263
Labels
editorial
a change to an example, note, spelling, grammar, or is related to publishing or the repo
Projects
Milestone
The Characteristics of Roles section has some inconsistencies that should be fixed up.
Problem 1:
A few (3) of the characteristics definitions have a "Value" type listed:
In 2 of those cases (Abstract and Presentational Children), this looks odd and out of place, and should probably just be deleted ("boolean" can be inferred from reading the prose). However, the list of values for the "Accessible Name Calculation" definition needs to be kept.
Looking back at the same section in ARIA 1.1, it looks like these sections were more formally defined in the past. Informal is fine, but we should make sure they're consistent with each other and with the characteristics tables in the role definitions.
Problem 2:
The names of these definition sections do not always exactly match the name used in the role characteristics tables. For example, Presentational Children is not the same as "Children Presentational".
This is particularly problematic in the case of Accessible Name Calculation which is "Name From" in the tables.
These definition names should all be identical to the characteristics table entries that they are defining.
Problem 3:
Probably because the section for Accessible Name Calculation is poorly named, it seems to have some extraneous subsections that I believe should be deleted. There's no reason to link to the accessible description or text alternative calculation in this (the "Name From" definition) section, so those 2 subsections (5.8.2 and 5.8.3) should be deleted.
Suggestion:
Consider also linking from the characteristics tables to the characteristic definitions. For example, "Supported States and Properties" in each table should link to the Supported States and Properties definition.
The text was updated successfully, but these errors were encountered: