Here's looking at you, kid
bachmeier via Digitalmars-d
digitalmars-d at puremagic.com
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 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.
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