On Wednesday, 16 December 2015 at 21:57:05 UTC, Walter Bright
wrote:
On 12/16/2015 7:32 AM, Jack Stouffer wrote:
3. "Who wants to spend hours and hours of work writing a DDoc
to Markdown
converter or manually convert all existing pages? Do we have
any volunteers?"
I can't even get consistent documentation of the parameters to
a function:
For example:
http://dlang.org/phobos/std_parallelism.html#.Task
What are 'fun' and 'Args' supposed to be? No example(s).
http://dlang.org/phobos/std_functional.html
Not a single appearance of 'Params:' or 'Returns:. Inconsistent
use of 'Example:' and 'Examples:'. Many missing examples. Etc.
There's plenty to be done to improve things that converting all
the pages to another format will not help with.
There's also weird stuff like this, with an outer template and a
documented inner template function.
http://dlang.org/phobos/std_parallelism.html#.TaskPool.amap.amap
