You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Laura Stewart (JIRA)" <de...@db.apache.org> on 2006/09/12 00:43:22 UTC
[jira] Created: (DERBY-1842) Accessibility of figures in Derby Docs
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.0
Reporter: Laura Stewart
Assigned To: Laura Stewart
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
[jira] Updated: (DERBY-1842) Accessibility of figures in Derby Docs
Posted by "Laura Stewart (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-1842?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Laura Stewart updated DERBY-1842:
---------------------------------
Attachment: derby842_2.diff
Attaching the patch derby1842_2.diff with all of the correction recommended by Stan and Jean.
I opened up 3 new JIRA issues to fix the graphics per Stans recommendations. These are:
Derby 2281, 2322, 2323.
> 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: 10.2.1.6
> Reporter: Laura Stewart
> Assigned To: Laura Stewart
> Attachments: derby1842_1.diff, derby1842_html.zip, derby1842_html2.zip, derby842_2.diff
>
>
> 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.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-1842) Accessibility of figures in Derby
Docs
Posted by "Laura Stewart (JIRA)" <ji...@apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1842?page=comments#action_12455810 ]
Laura Stewart commented on DERBY-1842:
--------------------------------------
To review the text, you must:
1. Unzip the file that contains the html and graphic files.
2. Open the file that you want to review
3. Position your mouse over the graphic and review the text that appears.
Does it accurately describe what the graphic depicts?
The purpose of this text is for people who cannot see the graphic and need the graphic explained to them verbally.
> 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
[jira] Updated: (DERBY-1842) Accessibility of figures in Derby Docs
Posted by "Laura Stewart (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-1842?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Laura Stewart updated DERBY-1842:
---------------------------------
Attachment: derby1842_3.diff
Realized I forgot to make a correction. The latest updated patch is
derby1842-3.diff
> 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: 10.2.1.6
> Reporter: Laura Stewart
> Assigned To: Laura Stewart
> Attachments: derby1842_1.diff, derby1842_3.diff, derby1842_html.zip, derby1842_html2.zip, derby842_2.diff
>
>
> 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.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-1842) Accessibility of figures in Derby Docs
Posted by "Laura Stewart (JIRA)" <ji...@apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1842?page=all ]
Laura Stewart updated DERBY-1842:
---------------------------------
Attachment: derby1842_1.diff
derby1842_html.zip
I have attached a patch (derby1843_1).diff file and
a zip file that contains the html and graphic files.
I need people who are familiar with the following topics to evaluate if the text that appears when your mouse is over a graphic (alternative text used for people with disabilities) is accurate.
Guide Filename Topic Title
devguide cdevdvlp27610 Derby system
devguide cdevdvlp40724 The database directory
devguide cdevdeploy855368 Embedded deployment application overview
devguide cdevdeploy855655 Deploying Derby in an embedded environment
devguide cdevconcepts28436 Deadlocks
devguide cdevconcepts16400 Configuring deadlock detection and lock wait timeouts
devguide cdevcsecuree Derby and Security
devguide cdevcsecure42374 Working with user authentication
tuning ctundepth32379 Using the statement cache
> 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
[jira] Updated: (DERBY-1842) Accessibility of figures in Derby Docs
Posted by "Laura Stewart (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-1842?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Laura Stewart updated DERBY-1842:
---------------------------------
Attachment: derby1842_html2.zip
Adding zip file with upated html files
> 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: 10.2.1.6
> Reporter: Laura Stewart
> Assigned To: Laura Stewart
> Attachments: derby1842_1.diff, derby1842_html.zip, derby1842_html2.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.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-1842) Accessibility of figures in Derby
Docs
Posted by "Jean T. Anderson (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-1842?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12465619 ]
Jean T. Anderson commented on DERBY-1842:
-----------------------------------------
Regarding:
> 1) The Alternate text does not pop up at all using my installation of FireFox (5.0; en-US; rv:1.8.0.9) but it works as advertised in IE.
ALT text won't display on mouse-over using Firefox or Safari -- the HTML standard doesn't require a browser to display ALT text unless the image can't be rendered. See the derby-dev topic starting at
http://mail-archives.apache.org/mod_mbox/db-derby-dev/200701.mbox/%3c9f40b500701161355ne5dc865l989a999f5e782bf6@mail.gmail.com%3e
> 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: 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: https://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] Commented: (DERBY-1842) Accessibility of figures in Derby
Docs
Posted by "Stan Bradbury (JIRA)" <ji...@apache.org>.
[ 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:1.8.0.9) 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 shows how Derby can reuse a statement execution plan that is already in the statement cache, even when the statement is executed from a 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 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 file.
Recommendations:
... 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 graphics. The top graphic displays a slightly more complicated deployment of a Derby system involving four objects: the derby.jar file, your application jar file, the derby.properties file and the database. The bottom graphic displays a simplified deployment of a Derby system involving two objects. The application jar file and the derby properties 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: 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: https://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] Resolved: (DERBY-1842) Accessibility of figures in Derby
Docs
Posted by "Laura Stewart (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-1842?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Laura Stewart resolved DERBY-1842.
----------------------------------
Resolution: Fixed
Derby Info: (was: [Patch Available])
Committed revision 508132.
> 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: 10.2.1.6
> Reporter: Laura Stewart
> Assigned To: Laura Stewart
> Attachments: derby1842_1.diff, derby1842_3.diff, derby1842_html.zip, derby1842_html2.zip, derby842_2.diff
>
>
> 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.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-1842) Accessibility of figures in Derby
Docs
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ 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 " " (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
[jira] Closed: (DERBY-1842) Accessibility of figures in Derby Docs
Posted by "Laura Stewart (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-1842?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Laura Stewart closed DERBY-1842.
--------------------------------
> 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: 10.2.1.6
> Reporter: Laura Stewart
> Assigned To: Laura Stewart
> Attachments: derby1842_1.diff, derby1842_3.diff, derby1842_html.zip, derby1842_html2.zip, derby842_2.diff
>
>
> 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.
-
You can reply to this email to add a comment to the issue online.
Re: Accessibility enhancements (was Re: [jira] Commented: (DERBY-1842)
Accessibility of figures in Derby Docs)
Posted by "Jean T. Anderson" <jt...@bristowhill.com>.
Laura Stewart wrote:
...
> For us to claim that the documentation is accessible, the graphic
> files need to contain hidden text that screen readers can read. The
> appearance of the text when the mouse hovers over the graphic is
> irrelevant from an accessibility standpoint. So if the line feed
> characters cause the text to appear disjointed in the textbox that is
> not important. It doen't look very good for those of us who can see
> the text, but we are not the target audience for this "alternative"
> text.
I really like the goals description on the w3c guidelines site [1]:
> The primary goal of these guidelines is to promote accessibility. However, following them will also make Web content more available to all users, whatever user agent they are using (e.g., desktop browser, voice browser, mobile phone, automobile-based personal computer, etc.) or constraints they may be operating under (e.g., noisy surroundings, under- or over-illuminated rooms, in a hands-free environment, etc.). Following these guidelines will also help people find information on the Web more quickly. These guidelines do not discourage content developers from using images, video, etc., but rather explain how to make multimedia content more accessible to a wide audience.
I'm already thinking how I can improve the Derby Tutorial at
http://db.apache.org/derby/papers/DerbyTut since I have to update it
anyhow for 10.2.2.0.
I don't think there's anything wrong with trying to make the text look
good as long as we understand why we're doing that -- sort of separate
the "must have" (we want screen readers to be able to read it) from the
"nice to have" (it'd be nice if the text were visible in an environment
in which the picture doesn't render well, or whatever).
-jean
[1] http://www.w3.org/TR/WAI-WEBCONTENT/
> BTW - thanks for the links :-)
>
> Laura
>
> On 1/24/07, Jean T. Anderson <jt...@bristowhill.com> wrote:
>
>> Jean T. Anderson wrote:
>> > Hi, Laura,
>> >
>> > I'm trying to understand the accessibility issues that DERBY-1842 wants
>> > to address. After a quick search I found the "Section 508" web site
>> for
>> > the U.S. govt, which looks like it has great links to all sorts of
>> > resources:
>> >
>> > http://www.section508.gov/
>> >
>>
>> browsing links from the section508 site, I found the w3c Content
>> Accessibility Guidelines:
>>
>> http://www.w3.org/TR/WAI-WEBCONTENT/
>>
>> this may have already been mentioned on derby-dev. If so, my apologies,
>>
>> -jean
>>
>
>
Re: Accessibility enhancements (was Re: [jira] Commented: (DERBY-1842) Accessibility of figures in Derby Docs)
Posted by Laura Stewart <sc...@gmail.com>.
You make a good point Jean. The purpose of DERBY-1842 is to ensure
that our graphic files adhere to the U.S. Federal Government
guidelines for accessiblility.
I updated the alt text for the graphic files because it was too vague.
What I needed was someone familiar with the subject matter to review
the text. That review can be performed in IE by hovering the mouse
over the graphic and reading the text.
In the course of asking for this review some other issues came to light.
1. We should not be using this hover over method to test for
accessibility. We should install screen readers and test the text that
way.
2. Not all browsers support the hover over method of viewing the text.
For us to claim that the documentation is accessible, the graphic
files need to contain hidden text that screen readers can read. The
appearance of the text when the mouse hovers over the graphic is
irrelevant from an accessibility standpoint. So if the line feed
characters cause the text to appear disjointed in the textbox that is
not important. It doen't look very good for those of us who can see
the text, but we are not the target audience for this "alternative"
text.
BTW - thanks for the links :-)
Laura
On 1/24/07, Jean T. Anderson <jt...@bristowhill.com> wrote:
> Jean T. Anderson wrote:
> > Hi, Laura,
> >
> > I'm trying to understand the accessibility issues that DERBY-1842 wants
> > to address. After a quick search I found the "Section 508" web site for
> > the U.S. govt, which looks like it has great links to all sorts of
> > resources:
> >
> > http://www.section508.gov/
> >
>
> browsing links from the section508 site, I found the w3c Content
> Accessibility Guidelines:
>
> http://www.w3.org/TR/WAI-WEBCONTENT/
>
> this may have already been mentioned on derby-dev. If so, my apologies,
>
> -jean
>
--
Laura Stewart
Re: Accessibility enhancements (was Re: [jira] Commented: (DERBY-1842)
Accessibility of figures in Derby Docs)
Posted by "Jean T. Anderson" <jt...@bristowhill.com>.
Jean T. Anderson wrote:
> Hi, Laura,
>
> I'm trying to understand the accessibility issues that DERBY-1842 wants
> to address. After a quick search I found the "Section 508" web site for
> the U.S. govt, which looks like it has great links to all sorts of
> resources:
>
> http://www.section508.gov/
>
browsing links from the section508 site, I found the w3c Content
Accessibility Guidelines:
http://www.w3.org/TR/WAI-WEBCONTENT/
this may have already been mentioned on derby-dev. If so, my apologies,
-jean
Accessibility enhancements (was Re: [jira] Commented: (DERBY-1842)
Accessibility of figures in Derby Docs)
Posted by "Jean T. Anderson" <jt...@bristowhill.com>.
Hi, Laura,
I'm trying to understand the accessibility issues that DERBY-1842 wants
to address. After a quick search I found the "Section 508" web site for
the U.S. govt, which looks like it has great links to all sorts of
resources:
http://www.section508.gov/
would this be a good starting point for understanding the issues? Or do
you have any favorite web sites you could point us to?
At any rate, I think the main objective of DERBY-1842 from its
description is to enable screen readers, right? Are the line break /
line feed issues and window sizing you mentioned especially important to
screen readers? Or are you trying to also enhance image information for
those of us who are not visually impaired -- sort of hit two birds with
one stone?
I'm kind of confused about the goal here, but am pretty clueless about
accessibility issues so welcome any info (or pointers to info).
thanks,
-jean
Laura Stewart (JIRA) wrote:
> [ https://issues.apache.org/jira/browse/DERBY-1842?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12466894 ]
>
> Laura Stewart commented on DERBY-1842:
> --------------------------------------
>
>
> The tool that I use does not show the line feed characters. However
> when I open the file in Notepad, the places where the line breaks
> coinsides with the line feed characters. While I can manually remove
> the line breaks, I would prefer to find a way in dita tagging to force
> either the size of the window to be larger or some other solution so
> that we don't have to worry about the authoring tool adding the line
> feeds.
>
> Incidently, when I use IE to view the text, the text breaks more often
> than the where the line feed characters are. For example, in the file
> ctundepth32379.html, the text appears in IE as:
>
> This figure shows one connection
> with multiple execution of the same PreparedStatement,
> which uses the same
> statement execution plan
>
> So for text that appears on one line in Notepad is truncated if it is
> too long for the default size of the text box in IE. This is a
> separate problem from the line feed character problem.
>
[jira] Commented: (DERBY-1842) Accessibility of figures in Derby
Docs
Posted by "Laura Stewart (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-1842?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12466894 ]
Laura Stewart commented on DERBY-1842:
--------------------------------------
The tool that I use does not show the line feed characters. However
when I open the file in Notepad, the places where the line breaks
coinsides with the line feed characters. While I can manually remove
the line breaks, I would prefer to find a way in dita tagging to force
either the size of the window to be larger or some other solution so
that we don't have to worry about the authoring tool adding the line
feeds.
Incidently, when I use IE to view the text, the text breaks more often
than the where the line feed characters are. For example, in the file
ctundepth32379.html, the text appears in IE as:
This figure shows one connection
with multiple execution of the same PreparedStatement,
which uses the same
statement execution plan
So for text that appears on one line in Notepad is truncated if it is
too long for the default size of the text box in IE. This is a
separate problem from the line feed character problem.
--
Laura Stewart
> 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: 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.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-1842) Accessibility of figures in Derby
Docs
Posted by "Stan Bradbury (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-1842?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12466601 ]
Stan Bradbury commented on DERBY-1842:
--------------------------------------
Finished the remainder:
========== cdevdeploy855368.html
Fig 1 and 2 text look good. One NIT about Fig 2 graphic: Labeling the middle box as Application Server would help differentiate it from Fig 1. Might not be worth the effort to change.
========== cdevconcepts16400.html
Fig 1: I could not confirm or refute that the deadlock check was only done once but the Alt text describes diagram.
Fig 2 and 3 are good.
========== cdevconcepts28436.html
Fig 1: Another NIT about the graphic: The transaction progress lines to go around (do not touch) the tables they have locks on. Typically a graphic shows the progress line going through the tables they have visited and locked. To understand this graphic I needed to read the text. But the text is correct.
========== cdevcsecuree.html
Fig 1 and 2: There is nothing inaccurate about this page but it does not help me understand these complex topics. I recommend revisiting this page when there is time to augment or rewrite the topic.
========== cdevdvlp40724.html
Fig 1: Not inaccurate but it would be more instructive to say:
"This figure shows the files that might be found in the main directory of a Derby database called Sales: the service.properties file and the directories log, seg0, tmp, and jar."
========== cdevdvlp27610.html
Fig 1 and 2: A-OK.
> 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: 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.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-1842) Accessibility of figures in Derby Docs
Posted by "Laura Stewart (JIRA)" <ji...@apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1842?page=all ]
Laura Stewart updated DERBY-1842:
---------------------------------
Derby Info: [Patch Available]
> 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
[jira] Commented: (DERBY-1842) Accessibility of figures in Derby
Docs
Posted by "Laura Stewart (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1842?page=comments#action_12434016 ]
Laura Stewart commented on DERBY-1842:
--------------------------------------
All of text for the figures should be reviewed to ensure that the text is complete and meaninful.
Graphics are in the following topics:
Developers Guide - 13 graphics
- Derby system = cdevdvlp27610 (1 graphic)
- The database directory = cdevdvlp40724 (1 graphic)
- Embedded deployment application overview = cdevdeploy855368 (2 graphics)
- Deploying Derby in an embedded environment = cdevdeploy855655 (1 graphic file, with 2 graphics)
- Deadlocks = cdevconcepts28436 (1 graphic)
- Configuring deadlock detection and lock wait timeouts = cdevconcepts16400 (3 graphics)
- Derby and Security = cdevcsecuree (1 graphic)
- Working with user authentication = cdevcsecure42374 (2 graphics)
Tuning Guide - 1 graphic
- Using the statement cache = ctundepth32379
> 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.0
> Reporter: Laura Stewart
> Assigned To: Laura Stewart
>
> 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