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

Common order of information in techniques and guidelines #479

Open
GeorgeKerscher opened this issue Nov 19, 2024 · 1 comment
Open

Common order of information in techniques and guidelines #479

GeorgeKerscher opened this issue Nov 19, 2024 · 1 comment
Labels
a11y-display-guide Issue with the UX Guide principles or techniques

Comments

@GeorgeKerscher
Copy link
Collaborator

The sections 4.5 Navigation and 4.10 Additional Information should be aligned with the guidelines in structure and the order of information.

This is an atomic issue derived from #471

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

Discrepancies I have noted here:

4.5 Navigation

In the Techniques, the list of navigation aids is constructed in a different order than what is seen in the compact explanation in the Display guide. If all conditions are met, the displayed explanation is:
"Navigation by table of contents, index, supports page navigation, and headings"

To match the order in the Display Guide Example 12, the Techniques would need to reverse the order of steps 3 and 4.

4.10 Additional accessibility information

  • In the Display guide, every feature is a separate explanation, but in the Techniques, features under one grouping heading are concatenated into a single comma and "and" separated string. I think they should be separate explanations (Sentence construction for translations #460 (comment)).
  • The Display guide mentions seven distinct headings to group features under. But in the Techniques, every feature is grouped under two of these (Adaptation and Clarity). Specifically:
    • In the ONIX Techniques, braille, tactile graphic, tactile object features are grouped under Adaptation.
      In the Display Guide, Tactile is a distinct heading for grouping content.
    • In the ONIX Techiques, "visible page numbering " is included under Clarity
      In the Display Guide 4.10, Page breaks is a distinct heading for grouping features.
    • In the EPUB Techniques, both Aria and page break markers are included under Clarity.
      In the Display Guide 4.10, Page breaks are a distinct heading and Aria is mentioned under Structure.
  • The Display guide links to the Techniques document using a heading "Book features" that does not exist in the Techniques.

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
Projects
None yet
Development

No branches or pull requests

4 participants
@mattgarrish @GeorgeKerscher @jonaslil and others