search

w3c / epub-specs

Shared workspace for EPUB 3 specifications.
Other
305 stars 60 forks source link

Addressing APA feedback in FXL Accessibility Document #2659

Open wareid opened 1 month ago

wareid commented 1 month ago

This PR includes some edits to address the feedback we received regarding the FXL Accessibility document from APA during our session with them at TPAC.

Two main changes:

  1. Adjusted the name of the document to include "Best Practices" to avoid confusion around conformance.
  2. Added text to further clarify the reading order section, including noting the difference between EPUB's concept of reading order and accessibility's concept of reading order.

Feedback welcome!

gautierchomel commented 1 month ago

Preview

gautierchomel commented 1 month ago

To me, the document still mix too many different problems for different audiences:

mattgarrish commented 1 month ago

What about matching the naming along the lines of our other accessibility documents and make it something like:

EPUB Accessibility -- Fixed Layout Challenges and Best Practices

GeorgeKerscher commented 1 month ago

I like this approach.

avneeshsingh commented 1 month ago

This will make the document look like EPUB Accessibility 1.1. This is exactly what we want to avoid. This document is more about best practices and challenges for fixed layout. It will take time and significant research to reach the level where we can say that it provides techniques for meeting EPUB Accessibility specifications.

mattgarrish commented 4 weeks ago

It puts it under the accessibility umbrella, but I don't think anyone would get too confused by a document called challenges and best practices.

The alternative would be to put these under the FXL umbrella, so have:

EPUB 3 Fixed Layouts -- Accessibility Challenges and Best Practices

I think the more problematic name is going to be the techniques document. If this is best practices, how do you differentiate that document without it sounding like a proper accessibility guide. But that's a problem for another day, I suppose.

avneeshsingh commented 4 weeks ago

This looks better:

“EPUB 3 Fixed Layouts -- Accessibility Challenges and Best Practices”

gautierchomel commented 4 weeks ago

The key sentence of the document is in the overview:

An accessible fixed layout EPUB file is one that meets the accessibility requirements of the Web Content Accessibility Guidelines 2.x level AA [wcag2] and EPUB Accessibility 1.1 [epub-a11y-11],

It may be more apparent to have this stated at the very beginning of the abstract section.

wareid commented 2 days ago

See: