TLC for ddox

Seb seb at wilzba.ch
Fri Nov 17 10:46:36 UTC 2017


On Friday, 17 November 2017 at 03:04:20 UTC, Andrei Alexandrescu 
wrote:
> Whenever I look at the documentation, I find things that could 
> be improved. Consider https://dlang.org/library/, one of the 
> most important pages - the portal - of the hopefully future 
> default documentation renderer. It goes something like this:
>
> ================
> Module	Description
> ================
> std.algorithm.comparison	This is a submodule of std.algorithm. 
> It contains generic comparison algorithms.
> std.algorithm.iteration	This is a submodule of std.algorithm. 
> It contains generic iteration algorithms.
> std.algorithm.mutation	This is a submodule of std.algorithm. It 
> contains generic mutation algorithms.
> std.algorithm.searching	This is a submodule of std.algorithm. 
> It contains generic searching algorithms.
> ...
> ================
>
> Makes you want to go postal, innit? Reminds me of this quote 
> from David Foster Wallace's unfinished The Pale King: 
> https://www.goodreads.com/quotes/621837-irrelevant-chris-fogle-turns-a-page-howard-cardwell-turns-a
>
> Can a kind volunteer please put some tender love care into that 
> page?
>
>
> Thanks,
>
> Andrei

This has already been partially fixed at ddox[1], but we can't 
upgrade ddox for the dlang.org build atm [2].

[1] https://github.com/rejectedsoftware/ddox/pull/165
[2] https://github.com/dlang/dlang.org/pull/1891



More information about the Digitalmars-d mailing list