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.
