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".
