Improved Phobos dox

Andrei Alexandrescu SeeWebsiteForEmail at erdani.org
Sun Sep 15 18:50:35 PDT 2013


On 9/15/13 11:43 AM, Jonathan M Davis wrote:
> 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

Probably I'll keep that in and drop the drop-down box.

Andrei




More information about the Digitalmars-d mailing list