Some feedback on the website.

Meta via Digitalmars-d digitalmars-d at puremagic.com
Wed Dec 16 14:00:50 PST 2015


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


More information about the Digitalmars-d mailing list