Improved Phobos dox

Jonathan M Davis jmdavisProg at gmx.com
Sun Sep 15 11:43:25 PDT 2013


On Sunday, September 15, 2013 10:47:06 Andrei Alexandrescu wrote:
> On 9/15/13 12:53 AM, Vladimir Panteleev wrote:
> > On Sunday, 15 September 2013 at 07:14:15 UTC, Andrei Alexandrescu wrote:
> >> Check out the new navigation at
> >> http://erdani.com/d/phobos/std_array.html. The ugly "Jump to" list as
> >> the top gets replaced by a slick drop-down. Once you jump to a name,
> >> you can go back by pressing the up arrow on the right or simply go to
> >> top.
> > 
> > I'm not sure this is an improvement, functionally. Finding the right
> > item in much faster when you can see all items at once, and not lined up
> > on only one direction.
> 
> Not sure what that's based on, but at least for me that only works up to
> a few words. For large modules that's hopeless. Just look at:
> 
> http://dlang.org/phobos/std_datetime.html
> 
> Can you really pick up the desired term? I think
> http://erdani.com/d/phobos/std_datetime.html is a real improvement over
> that (it also reduces the size of the list to the top-level ones, which
> helps).

It's an improvement because it shows the top-level symbols only rather than 
putting all of the symbols inside of the types at the top level like the 
current links do. The fact that it's a drop-down hurts rather than helps.

- Jonathan  Davis


More information about the Digitalmars-d mailing list