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

Need some clarification on a previous issue #489

Open
GeorgeKerscher opened this issue Nov 21, 2024 · 2 comments
Open

Need some clarification on a previous issue #489

GeorgeKerscher opened this issue Nov 21, 2024 · 2 comments
Labels
a11y-display-guide Issue with the UX Guide principles or techniques a11y-display-techniques-onix Issue with the onix accessibility metadata display techniques

Comments

@GeorgeKerscher
Copy link
Collaborator

On #471 @wareid
made several comments.

Could we please get clarification?

First:
• For the EPUB metadata, this also requires additional logic to parse and split the value provided in dcterms:conformsTo which while not difficult, requires additional processing that seems unnecessary.
Please elaborate on what is not necessary.
Second:
Mentions of metadata properties in the ONIX and EPUB metadata docs are not made in the main document, which adds to the confusion.
We have a note that not all of the Additional Information is catalogued in the guidelines. Listing all of them would make the guidelines much longer and many of these are not frequently used.
What do you suggest?
Add or remove reactions

@mattgarrish
Copy link
Member

mattgarrish commented Nov 21, 2024

For the EPUB metadata, this also requires additional logic to parse and split the value provided in dcterms:conformsTo which while not difficult, requires additional processing that seems unnecessary.

Looking at the original issue, I believe this is related to why the strings are being parsed rather than matched. It sounds like kobo would reject a string that isn't a full conformance statement, but this processing could match invalid conformance statements and even statements that don't have anything to do with accessibility or that use WCAG-like terms for an internal standard (e.g., there's no reason "Level A" couldn't be part of a conformance statement that has nothing to do with accessibility). The techniques assume there's only an accessibility conformance statement and that it's a valid one.

It might be safer to pattern match off the full conformance string/url since the epub and wcag versions, and the wcag levels, are always in predictable spots.

@mattgarrish mattgarrish added the a11y-display-guide Issue with the UX Guide principles or techniques label Nov 21, 2024
@mattgarrish
Copy link
Member

This is also an issue in the onix techniques. The algorithm assumes all the information about epub and wcag conformance has been set, but if only the level is set, for example, you could get weird statements like:

Conformance
This publication meets accepted accessibility standards
Detailed conformance information
This publication claims to meet Level AA

We aren't verifying that the information is complete before using it. The pending changes to the epub algorithm will prevent this from happening for package metadata.

@mattgarrish mattgarrish added the a11y-display-techniques-onix Issue with the onix accessibility metadata display techniques label Nov 29, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
a11y-display-guide Issue with the UX Guide principles or techniques a11y-display-techniques-onix Issue with the onix accessibility metadata display techniques
Projects
None yet
Development

No branches or pull requests

2 participants