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

Simple language changes #490

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Conversation

GeorgeKerscher
Copy link
Collaborator

This address issues 486 and 465.
@[email protected]

submitted 486, which were excellent edits in many places.

@[email protected]
Mark submitted 465, which adds libraries to the list of who should use these guidelines.

No changes were made to strings. Only the primary guidelines were changed.

these images; are there page numbers which are accessible; is the reading order correct so a caution
after reading a paragraph which could be dangerous will be announced? All of these, and more
accessibility concerns are potential issues consumers have when trying to purchase and ultimately read a
these images; are there page numbers which are accessible; is the reading order correct so a caution will be announced before reading the paragraph which could be dangerous? All of these accessibility concerns are potential issues consumers have when trying to purchase and ultimately read a
Copy link
Member

Choose a reason for hiding this comment

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

I understand the intent, but this amusingly sounds like reading paragraphs is dangerous.

Maybe the focus could be returned to the content, so phrase this as "is the reading order correct so a caution is announced before dangerous instructions".

specific accessibility needs.</p>

<p>All accessibility metadata is meant to be machine-readableexcept for the accessibility summary - in
<p>All accessibility metadata is meant to be machine-readable, except for the accessibility summary. in
this way accessibility metadata can be extracted and displayed uniformly across different publications
Copy link
Member

Choose a reason for hiding this comment

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

A summary can be read by machine, but it's not really processable in the same way as controlled terms, so I'm not sure this is the best explanation. Maybe this could be:

Most accessibility metadata uses controlled vocabularies to allow it to be extracted and displayed uniformly across different publications and localized to different user interface languages. The one exception is the accessibility summary, which allows accessibility statements that are unique to a publication.

But I wonder if we really need to get into the technicality of the summary. Maybe the last sentence could just be dropped.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants