Thread overview
How does one get to the root of a package in ddox?
Apr 16, 2016
Sönke Ludwig
Apr 16, 2016
Sönke Ludwig
Jun 11, 2016
Martin Nowak
April 15, 2016
Say you're on https://dlang.org/library/std/range/primitives.html and try to find your way to https://dlang.org/library/std/range.html.

Clicking on "range" in the navigation panel doesn't help - it just collapses/expands the tree branch.

What's the design here?


Thanks,

Andrei
April 16, 2016
Am 15.04.2016 um 22:38 schrieb Andrei Alexandrescu:
> Say you're on https://dlang.org/library/std/range/primitives.html and
> try to find your way to https://dlang.org/library/std/range.html.
>
> Clicking on "range" in the navigation panel doesn't help - it just
> collapses/expands the tree branch.
>
> What's the design here?
>
>
> Thanks,
>
> Andrei

Oh yeah, this is something that has been bugging me for a while, but I haven't got around to fix. The problem is that due to the way the navigation menu currently works, there need to be two entries for packages that have a package.d (the upper one will snap in/out while the bottom one will open the package documentation). We'd have to change the UI to be more like a classical tree control with a +/- box at the left.
April 16, 2016
Am 16.04.2016 um 07:38 schrieb Sönke Ludwig:
> Am 15.04.2016 um 22:38 schrieb Andrei Alexandrescu:
>> Say you're on https://dlang.org/library/std/range/primitives.html and
>> try to find your way to https://dlang.org/library/std/range.html.
>>
>> Clicking on "range" in the navigation panel doesn't help - it just
>> collapses/expands the tree branch.
>>
>> What's the design here?
>>
>>
>> Thanks,
>>
>> Andrei
>
> Oh yeah, this is something that has been bugging me for a while, but I
> haven't got around to fix. The problem is that due to the way the
> navigation menu currently works, there need to be two entries for
> packages that have a package.d (the upper one will snap in/out while the
> bottom one will open the package documentation). We'd have to change the
> UI to be more like a classical tree control with a +/- box at the left.

Alternatively, the package.d entry could be put as the first child item of its package and get a special name (e.g. "Package documentation").
April 16, 2016
On 4/16/16 1:49 AM, Sönke Ludwig wrote:
> Alternatively, the package.d entry could be put as the first child item
> of its package and get a special name (e.g. "Package documentation").

That sounds good! -- Andrei
June 11, 2016
On 04/16/2016 07:38 AM, Sönke Ludwig wrote:
> Am 15.04.2016 um 22:38 schrieb Andrei Alexandrescu:
>> Say you're on https://dlang.org/library/std/range/primitives.html and try to find your way to https://dlang.org/library/std/range.html.
>>
>> Clicking on "range" in the navigation panel doesn't help - it just collapses/expands the tree branch.

Also the links in the fully qualified name (at the top) should include
links to the package.

Module std.range.primitives
(https://dlang.org/library/std/range/primitives.html)
  range -> std/range.html

Enum member std.range.primitives.isOutputRange
(https://dlang.org/library/std/range/primitives/is_output_range.html)
  range -> std/range.html
  primitives -> std/range/primitives.html