d-programming-language.com

[Jacob Carlborg]

On 2011-12-11 07:52, Andrei Alexandrescu wrote:
> On 12/10/11 10:14 PM, Adam D. Ruppe wrote:
>> Andrei Alexandrescu Wrote:
>>> Anything automated rox.
>>
>> cool. I updated the program today to handle the new site. Take a
>> look at the output:
>>
>> http://arsdnet.net/d-web-site/std_stdio.html
> [snip]
>
> Yah, there's definite improvement. Adding categorization by hand will
> certainly help, and I think the program should not specify
> "Uncategorized" when there's no other category. There should also be no
> line after the category - color and boldface should be distinguishing
> enough.
>
> We could later on experiment with some collapsible stuff.
>
> Overall I see no shame in generating structured output with ddoc and
> then postprocessing it. Ddoc is supposed to generate structured
> documentation from code, not advanced cross-reference stuff and the
> such. Of course local improvements do make sense (e.g. distinguish
> member names from top-level names etc).

I think this is the wrong approach and I think ddoc should generate 
cross-references.

-- 
/Jacob Carlborg