Here's looking at you, kid

[bachmeier via Digitalmars-d]

On Friday, 13 November 2015 at 22:34:18 UTC, Andrei Alexandrescu 
wrote:
> Hi everyone,
>
>
> Recently there's been an uptick of site visits on dlang.org and 
> also dmd downloads (http://erdani.com/d/downloads.daily.png).
>
> Amid increased scrutiny it's important to focus on improving 
> documentation. I suggest everyone in the community to consider 
> improving dlang.org in any way. For Phobos in particular, the 
> lack of documentation and examples for some really useful 
> artifacts is damaging. Sometimes all it takes is adding "///" 
> to one unittest.
>
>
> Thanks,
>
> Andrei

I've proposed this before but it didn't get much attention, so 
let me bring it up again.

In a lot of cases there are already good explanations in Ali's 
book or on the wiki, but new users won't know about them. We 
could greatly improve the quality of the documentation at almost 
no cost by adding links to those documents. It wouldn't be a good 
idea to link to arbitrary sites, but I don't see any reason to 
not link to those two sources, as opposed to waiting for someone 
to reinvent the wheel.