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

Reply via email to