[JAVASERVERFACES_SPEC_PUBLIC-1214] Javadoc fails accessibility requirements for color contrast Created: 06/Aug/13  Updated: 01/Aug/14  Resolved: 28/Aug/13

Status: Closed
Project: javaserverfaces-spec-public
Component/s: Documentation: Javadoc, TLDDoc, RenderkitDoc, PDF
Affects Version/s: 2.2
Fix Version/s: 2.3

Type: Bug Priority: Major
Reporter: Kim Haase Assignee: Kim Haase
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: 0 minutes
Time Spent: 2 hours, 28 minutes
Original Estimate: Not Specified

Attachments: Text File changebundle.txt     HTML File file01-cc.html     HTML File file02-facelets-ui.html     HTML File file03-javascript.html     HTML File file04-mainpage.html     Java Archive File javax.faces-api-2.2-SNAPSHOT-javadoc.jar    

 Description   

The Facelets and JavaScript documentation for JSF fail accessibility requirements for color contrast. Sorry I missed this before.

I'll attach the output of the color contrast analyzer for four pages that fail: the main page for the Facelets Tag Library doc, the main page for composite components, the main page for Facelets templating, and one of the JavaScript pages (jsf). You only have to worry about the table rows that are red.

In most cases the colored fonts need to be darker. For the JavaScript pages, it might be sufficient to make the typeface bold for the white-on-blue table headings.



 Comments   
Comment by Kim Haase [ 06/Aug/13 ]

Whoops, I can't attach files. I will send them in email.

Comment by Ed Burns [ 26/Aug/13 ]

Updated to avoid A11Y violations.

Comment by Ed Burns [ 26/Aug/13 ]

Also, I attached a javadoc jar (which you can just unzip with the zip
tool) that has the changes applied.

Kim, I'm assigning the issue to you. Please confirm the changes achieve
compliance and let me know. I'll commit when whe achieve compliance.

Thanks,

Ed

Comment by Kim Haase [ 26/Aug/13 ]

Thanks very much, Ed. It's all fixed except for one page:

vdldocs/facelets/f/tld-summary.html

On this page, the equals signs next to the red text are green (it's hard to see between the black and the red) – so the color contrast fails. You might as well make the page black-and-white like the others.

Comment by Ed Burns [ 27/Aug/13 ]

I've just attached another iteration, fixing the problem you mentioned. Please verify.

Comment by Kim Haase [ 27/Aug/13 ]

Thanks, Ed! The fix works.

Comment by Ed Burns [ 28/Aug/13 ]

Kim, please mark this closed when the docs have been published.

Comment by Manfred Riem [ 01/Aug/14 ]

Closing resolved issue out

Generated at Thu Dec 08 08:33:44 UTC 2016 using JIRA 6.2.3#6260-sha1:63ef1d6dac3f4f4d7db4c1effd405ba38ccdc558.