[
https://issues.apache.org/jira/browse/DERBY-5135?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13007191#comment-13007191
]
Kim Haase commented on DERBY-5135:
----------------------------------
Tables in the Derby documentation have some accessibility problems that don't
seem easy to fix.
Accessible tables require a summary attribute. Currently the tables in the
frames HTML docs have empty summary attributes:
summary=""
DITA, even in its more recent versions, does not have an attribute to specify a
table summary. Providing a meaningful summary for each table would require some
complicated processing, maybe of a comment in the topic source.
Also, accessibility requires that table headers and table cells be linked by an
id value. Table headers specify an id for each column:
<th valign="top" width="50%" id="N100A8">Before Transformation</th>
<th valign="top" width="50%" id="N100AF">After Transformation</th>
Table cells then reference this id in their headers attribute -- except that in
formal tables, our DITA toolkit puts an extra space in the id that makes it
invalid:
<td valign="top" width="50%" headers="N100A8 "><strong><samp class="codeph">c1
< ANY (SELECT ...)</samp></strong></td>
<td valign="top" width="50%" headers="N100AF "><strong><samp class="codeph">c1
< (SELECT ...)</samp></strong></td>
The simpletable and choicetable elements are generated correctly, but formal
tables aren't. I have not been able to figure out what's wrong with the formal
table generation.
> Derby documentation needs accessibility improvements
> ----------------------------------------------------
>
> Key: DERBY-5135
> URL: https://issues.apache.org/jira/browse/DERBY-5135
> Project: Derby
> Issue Type: Task
> Components: Documentation
> Affects Versions: 10.7.1.1
> Reporter: Kim Haase
> Assignee: Kim Haase
>
> 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.
--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira
