[DERBY-5135] Derby documentation needs accessibility improvements

• Type: Task
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 10.7.1.1
• Fix Version/s: 10.8.2.2, 10.9.1.0
• Component/s: Documentation
• Assignee: Camilla Haase
• Reporter: Camilla Haase
• Created: 15/Mar/11 20:54
• Updated: 09/Oct/12 19:26
• Resolved: 04/Jun/12 17:45

Description

Accessibility is increasingly important for documentation. The Derby HTML documentation currently fails accessibility requirements, although the frames versions of the manuals seem closer to accessibility than the single-file HTML versions.

I will file a sub-task for some fairly easy fixes to the documentation and will describe some of the harder problems in a comment later.

Issue Links

• incorporates: DERBY-4408 missing DOCTYPE and META tags in toc.html and index.html pages

Sub-Tasks

• Simple accessibility fixes to frames HTML doc output: Closed
• Tables in documentation should not have empty cells: Closed
• Fix uses of <alt> and <desc> elements and figure captions: Closed
• Accessibility fixes needed for top-level and demo pages: Closed
• Accessibility fixes needed for release notes: Closed
• Tables in documentation need introductions and formatting fixes: Closed
• More accessibility fixes needed for demo pages: Closed
• Documentation: toc.html files need lang attribute: Closed
• Fix more difficult table problems: Closed
• Use <desc> element for table summary: Closed
• Preformatted text should not be used for graphic: Closed