Usability of D for Visually Impaired Users

[ag0aep6g via Digitalmars-d]

On 09/06/2016 08:47 PM, Sai wrote:
> 1. The "Jump to" section at the top lists all the items available in
> that module nicely, but the layout could be improved if it were listed
> as a bunch of columns instead of one giant list with flow layout.

That's a solid idea. Unfortunately, variance in name length is large. 
Might be hard to find a good column width. But it's definitely worth 
exploring.

> Even better if they are listed as the "cheat sheet" available in
> algorithm module (which is lovely BTW). Can this cheat sheet be
> automated for all modules?

The newer, DDOX-based version of the documentation has generated tables 
like that. You can find those docs here:

http://dlang.org/library-prerelease/index.html

It's supposed to become the main/default form of documentation 
soonishly. One thing we have to figure out is how to consolidate the 
hand-written cheat sheets with the generated ones. For example, 
std.algorithm modules currently have both. That's confusing for the reader.

> 2. I know red is the color of Mars, is there any way to change the theme
> to blue or something soft?

Principally, we could offer an alternative stylesheet with another 
color. That's going to be forgotten during maintenance, though, 
especially if the demand for it is low.

> Since we can download the documentation, is
> there an easy way to do it myself maybe?

You can of course edit the stylesheet. In the zip, that's 
dmd2/html/d/css/style.css.

The color codes for the different reds are mentioned in a comment at the 
top. I hope they're up to date. A couple search/replace operations 
should take care of most of it.

The logo is colored independently. It's a relatively simple SVG file. 
Just edit the "background" color in dmd2/html/d/images/dlogo.svg.

I'm not sure if this qualifies as "easy".