std.containers - WAT

Steven Schveighoffer schveiguy at yahoo.com
Thu Mar 29 07:12:32 PDT 2012


On Wed, 28 Mar 2012 10:37:30 -0400, Andrei Alexandrescu  
<SeeWebsiteForEmail at erdani.org> wrote:

> On 3/27/12 10:58 PM, Alex Rønne Petersen wrote:
>>> I think one more thing that needs some changing is the usability of
>>> the documentation, right now you get a dense list at the top, in
>>> mostly-alphabetical order (I think it puts caps first, then lower
>>> case) and then you get a massive list of classes and functions that
>>> are difficult to navigate.
>>
>> I think basically everyone dislikes this.
>
> I agree, and I think std.algorithm offers a good alternative without  
> requiring changes to ddoc. This is a good place where the community  
> might greatly help - it's work that's neither too difficult nor too  
> boring, and has huge impact.

This is precisely the wrong way to fix this.  DDoc needs to be fixed in  
the compiler.  It's one of the lowest hanging fruits I think we have (a  
great concept (using compiler knowledge of code structure to generate  
documentaiton) that is poorly implemented).

-Steve


More information about the Digitalmars-d mailing list