db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Stan Bradbury (JIRA)" <j...@apache.org>
Subject [jira] Commented: (DERBY-1842) Accessibility of figures in Derby Docs
Date Wed, 17 Jan 2007 23:51:30 GMT

    [ https://issues.apache.org/jira/browse/DERBY-1842?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12465612

Stan Bradbury commented on DERBY-1842:

I'm going through these files and wanted to enter these first two suggestions since one requires
changing a graphic which might require longer than just changing text.

Two presentation ?browser? Comments:  
1) The Alternate text does not pop up at all using my installation of FireFox (5.0; en-US;
rv: but it works as advertised in IE.
2) The alternative text does not display long enough for me to read all the text (I get through
about four lines).  Can this be controlled?

Suggestions for files:    ctundepth32379.html   and  cdevdeploy855655.html 
 = = = = = = =  ctundepth32379.html 
Fig 1: Small thing:  'execution' should be plural (I think. it is in the Figure title text):
 '...multiple executions of...'

Fig 2 (OUCH): Fig 2: The graphic is not correct - I suggest a horizontal line separating Connection
One and Connection Two (line should run under the TOP select, it's three exection-arrows and
the TOP Statement Object) - label: 'Connection One' should be ABOVE the Select statement and
FIRST execution-arrow for the Connection (not below an execution-arrow).  
Label 'Connection Two' should be above the SECOND select (below the added line) and it's FIRST
execution-arrow (the second solid arrow).  This arrow needs to be the only arrow pointing
to the SECOND Statement Object.
Replace the dotted line at the bottom with a STRAIGTH, SOLID line that runs STRAIGHT between
the BOTTOM select statement and the BOTTOM (third) Statement Object.  There is no 'elbow'
arrow for the second connection.
It is not clear that the only the TOP select AND the TOP Statement Object are part of Connection
One.  All three Connection One execution-arrows need to point to the SAME (TOP) Statement
Object.  The next TWO selects, exectuion-arrows and Statement Objects need to be in   do not
line up properly .    --The arrows between the Statment Objects and the Statement Cache pages
are good.

The corrected 'alt' text : 
This figure&#10;shows how Derby can reuse a statement execution plan that is already&#10;in
the statement cache, even when the statement is executed from a&#10;different connection."

  = = = = = = =    cdevdeploy855655.html
COMMENTS: Since you are referring to Derby as part of an application deployment it would be
clearer to use a term like 'Derby application' or 'Derby system'.  Also, it is confusing to
show two things in one figure so I suggest referring to Fig 1-top and Fig 1-bottom.  The only
thing that was technically wrong was the statement in the <img> alt text ".. the derby.properties
files&#10;are stored in the database.." - no derby.properties file is used in the simplified
deployment - the individual property settings are stored in the database, not the properties

  ... Change title associated with Figure 1 to:
Figure 1. The top graphic shows deploying an application, the Derby software for embedded
use, the derby.properties file and the database as four objects. The bottom graphic shows
how simplify deployment by reducing the number of objects to two by storing the application
and property settings in the database. 

... Change the 'ALT' text to:
<img src="edeploy_os.gif" alt="This figure shows two&#10;graphics. The top graphic
displays a slightly more complicated deployment&#10;of a Derby system involving four objects:
the derby.jar file, your application jar file, the derby.properties&#10;file and the database.
The bottom graphic displays a simplified&#10;deployment of a Derby system involving two
objects. The application jar file and the derby properties&#10;are stored in the database.
Only the derby.jar file is outside the database." />

> Accessibility of figures in Derby Docs
> --------------------------------------
>                 Key: DERBY-1842
>                 URL: https://issues.apache.org/jira/browse/DERBY-1842
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions:
>            Reporter: Laura Stewart
>         Assigned To: Laura Stewart
>         Attachments: derby1842_1.diff, derby1842_html.zip
> All of the figures in the Derby documentation do have alternative text which enables
people with 
> disabilities to interpret the figures with screen readers.
> There is one figure in file cdevdeploy855655 where
> the figure description is so poor as to be useless.

This message is automatically generated by JIRA.
If you think it was sent incorrectly contact one of the administrators: https://issues.apache.org/jira/secure/Administrators.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira


View raw message