RE: HTML Documentation Question

  • From: "Sina Bahram" <sbahram@xxxxxxxxx>
  • To: <programmingblind@xxxxxxxxxxxxx>
  • Date: Mon, 8 Oct 2007 16:27:01 -0400

Agreed

Take care,
Sina
 

-----Original Message-----
From: programmingblind-bounce@xxxxxxxxxxxxx
[mailto:programmingblind-bounce@xxxxxxxxxxxxx] On Behalf Of Léonie Watson
Sent: Monday, October 08, 2007 4:06 PM
To: programmingblind@xxxxxxxxxxxxx
Subject: RE: HTML Documentation Question

Jim,

        Although not strictly speaking a list, I would still use a list for
functions with only one parameter. This will help build consistency within
the help file and also provide a reliable means of navigating through with a
screen reader.

Regards,
Léonie 

-----Original Message-----
From: programmingblind-bounce@xxxxxxxxxxxxx
[mailto:programmingblind-bounce@xxxxxxxxxxxxx] On Behalf Of
james.homme@xxxxxxxxxxxx
Sent: 08 October 2007 20:09
To: programmingblind@xxxxxxxxxxxxx
Subject: HTML Documentation Question


Hi,
I'm working on putting the old JAWS scripting manual into CHM format. This
is kind of on topic, so don't get upset. In the documentation, it lists some
functions along with parameters. Some have no parameters and some have one.
Others have more than one. Here is my question. When a function has more
than one parameter, I'm making a bulleted list that contains a list item for
each parameter. Would you prefer to see no list for the parameters with one
or less parameters or a list with one list item in it?

Thanks.

Jim



James D Homme, , Usability Engineering, Highmark Inc.,
james.homme@xxxxxxxxxxxx, 412-544-1810

"It's more important for me to start to do the right thing than it is to
wait until I think I can do it just right."


__________
View the list's information and change your settings at
//www.freelists.org/list/programmingblind


__________
View the list's information and change your settings at
//www.freelists.org/list/programmingblind

__________
View the list's information and change your settings at
//www.freelists.org/list/programmingblind

Other related posts: