[OT] Re: Redesign of dlang.org

[w0rp via Digitalmars-d]

On Sunday, 27 July 2014 at 06:10:09 UTC, Andrei Alexandrescu 
wrote:
> On 7/26/14, 8:47 PM, H. S. Teoh via Digitalmars-d wrote:
>> On Sat, Jul 26, 2014 at 07:39:50PM -0700, Andrei Alexandrescu 
>> via Digitalmars-d wrote:
>>> On 7/26/14, 6:30 PM, w0rp wrote:
>>>> The std.algortihm documentation doesn't look good, and I 
>>>> don't have
>>>> any good ideas for it.
>>>
>>> I find std.algorithm among the best documented libraries out 
>>> there! I
>>> must be in denial... -- Andrei
>>
>> "No, I'm not in denial! It can't be!!!"
>
> Well correction: I think it's among the better documented 
> modules in std. -- Andrei

It's not the text, it's just the current formatting. The cheat 
sheet can't fit into a smaller column size as a table. So you can 
break that down into smaller headings and paragraphs instead so 
it will reflow, but then the length of the page gets bumped up 
quite a bit and makes it harder to find things at a glance.

Because it's probably the most important library in all of 
Phobos, it's probably worth excluding the usual output of lists 
of Functions, Structs, etc. from std.algortihm and letting the 
cheat sheet itself be the list of symbols, which is organised a 
lot better than a sort by symbol type then name will ever be. I 
like the "these are for iteration" kind of categorisation. I'd 
probably then remove the table right at the top, so you have the 
module description and example above the fold.

That's what I'm thinking at the moment anyway.