Here's looking at you, kid

bachmeier via Digitalmars-d digitalmars-d at
Fri Nov 13 16:37:15 PST 2015

On Friday, 13 November 2015 at 22:34:18 UTC, Andrei Alexandrescu 
> Hi everyone,
> Recently there's been an uptick of site visits on and 
> also dmd downloads (
> Amid increased scrutiny it's important to focus on improving 
> documentation. I suggest everyone in the community to consider 
> improving 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.

More information about the Digitalmars-d mailing list