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

ARIA: Editorial cleanup needed to "Presentational Roles Conflict Reso… #852

Merged
merged 5 commits into from Mar 3, 2020

Conversation

carmacleod
Copy link
Contributor

@carmacleod carmacleod commented Nov 30, 2018

…lution" section #646

Please see #646 (comment) for reviewing suggestion.

Resolves #646.


Preview | Diff

index.html Outdated Show resolved Hide resolved
@jnurthen jnurthen added the Agenda label Apr 9, 2019
@jnurthen jnurthen removed the Agenda label Jun 5, 2019
index.html Outdated Show resolved Hide resolved
Copy link
Member

@scottaohara scottaohara left a comment

Choose a reason for hiding this comment

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

see comment please.

@carmacleod
Copy link
Contributor Author

@joanmarie
I really need your review on this, because I had to resolve conflicts with PR #885 and I'm not 100% sure that I addressed all of your concerns. Particularly with that middle point there, about required owned elements.

Here's a preview link to the Presentational Roles Conflict Resolution section.

index.html Outdated Show resolved Hide resolved
index.html Outdated Show resolved Hide resolved
index.html Outdated Show resolved Hide resolved
Copy link
Contributor

@joanmarie joanmarie left a comment

Choose a reason for hiding this comment

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

See inline comments for proposed changes.

@scottaohara
Copy link
Member

approved the changes per my comments, but +1 to @joanmarie's comments

- remove understandable
- remove "user agent MAY resort to an internal recovery mechanism"
@carmacleod
Copy link
Contributor Author

Hi, @mcking65! This PR is ready for review.

Note that the Diff is messy because I reorganized words and moved things into a bulleted list.
The Preview is definitely easier to follow.

I only changed the prose in the Presentational Roles Conflict Resolution section (nothing else), so there's only 3 paragraphs plus the example to review (the bulleted list is in paragraph 2).

Note that the phrase "or otherwise interactive" is still being discussed in #1192, so for now, I think we should just keep that phrase as-is in order to get this PR merged sooner.

@mcking65
Copy link
Contributor

The example helps a lot, but I am concerned about an example that goes against APG guidance. We caution against using aria-label on a heading.

@carmacleod carmacleod linked an issue Feb 28, 2020 that may be closed by this pull request
add "with its implicit role" for clarity
@carmacleod
Copy link
Contributor Author

@mcking65 Notes for the latest commit:

  • changed example to use aria-describedby on the heading instead of aria-label
  • added "with its implicit role" in 2 places (for clarity on how UA should expose element)

@carmacleod
Copy link
Contributor Author

@jnurthen Example is fixed up. Here's the ping you requested. :)

@jnurthen jnurthen merged commit bf28544 into master Mar 3, 2020
jnurthen pushed a commit that referenced this pull request Mar 4, 2020
#852)

* ARIA: Editorial cleanup needed to "Presentational Roles Conflict Resolution" section #646
* - remove references to accessibility API mappings
- remove understandable
- remove "user agent MAY resort to an internal recovery mechanism"
* Make "User agents" the subject of the MUST NOT.
* Remove "host language" and link "elements" to definition
* use aria-describedby on h1 instead of aria-label
add "with its implicit role" for clarity
carmacleod added a commit that referenced this pull request May 7, 2020
#852)

* ARIA: Editorial cleanup needed to "Presentational Roles Conflict Resolution" section #646
* - remove references to accessibility API mappings
- remove understandable
- remove "user agent MAY resort to an internal recovery mechanism"
* Make "User agents" the subject of the MUST NOT.
* Remove "host language" and link "elements" to definition
* use aria-describedby on h1 instead of aria-label
add "with its implicit role" for clarity
@jnurthen jnurthen deleted the issue646 branch July 23, 2020 22:27
@pkra pkra mentioned this pull request Jan 10, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
5 participants