db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Kim Haase (JIRA)" <j...@apache.org>
Subject [jira] Commented: (DERBY-1842) Accessibility of figures in Derby Docs
Date Mon, 11 Dec 2006 20:55:22 GMT
    [ http://issues.apache.org/jira/browse/DERBY-1842?page=comments#action_12457472 ] 
            
Kim Haase commented on DERBY-1842:
----------------------------------

Unfortunately, I'm not a content expert in these areas. But the descriptions look just fine
to me except for a few minor things.

The alt text strings all seem to have "&#10;" (line feed) characters in them. These cause
a line break in the popup window. There seems to be a default box size and autowrap (in IE
and Firefox, anyway), so are the line feeds necessary? The problem is that if you right-click
and choose "Properties" for the figure, you only get the part of the string up to the first
line break. If you do want to leave the line breaks in, you might think about making the line
segments the same size as much as possible to avoid the jagged visual effects, and to put
the first one at a meaningful point so that Properties shows something useful. 

Deadlocks (cdevconcepts28436): I'm not sure there's anything you can do about this, but it
is odd that the description of the situation in the text that is inside the figure is the
opposite of the description of the situation in the topic text. For example, the text in the
figure says, "Transaction A has a lock on orders and needs a lock on accounts..." But the
topic text says, "Transaction A might hold a lock on some rows in the Accounts table and needs
to update some rows in the Orders table..." The alt text you provided for the figure assumes
the topic text is correct and the figure text is wrong. It's hard to tell which is correct,
because it's not clear what the arrows in the figure text are supposed to mean -- do they
mean "has a lock on" or "needs a lock on"? It would seem that either the figure text should
be corrected -- which might be hard to do -- or the descriptions should be changed to match
the figure text.

In "Embedded deployment application overview" (cdevdeploy855368), both alt text captions begin
"This figures shows".

In "Derby system" (cdevdvlp27610), shouldn't "that name of your system directory" be "the
name of ..."?

In "Using the statement cache" (ctundepth32379), "multiple execution" should be "multiple
executions".

> Accessibility of figures in Derby Docs
> --------------------------------------
>
>                 Key: DERBY-1842
>                 URL: http://issues.apache.org/jira/browse/DERBY-1842
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.2.1.6
>            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: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

Mime
View raw message