On Thursday, 19 November 2015 at 02:22:14 UTC, Jeremy DeHaan
wrote:
On Sunday, 15 November 2015 at 13:50:36 UTC, Warwick wrote:
On Sunday, 15 November 2015 at 11:46:54 UTC, Saurabh Das wrote:
On Friday, 13 November 2015 at 22:34:18 UTC, Andrei
Alexandrescu wrote:
[...]
This is slightly off-topic, but: I've been encouraging my
friends and colleagues to use Dlang over the last year and
the one pain point they constantly tell me about is that the
documentation website is "difficult to use" and "looks
intimidating".
The problem is you click on "Language Reference" and what you
actually get is a "Language Specification".
Which is funny, because I think the specification page is
actually a decent reference.
http://dlang.org/spec.html
It is a decent reference for you because you understand it. For
programmers who aren't as experienced / knowledgeable as you,
it's looks like gibberish.
We have to put ourselves in the shoes of those who are just
getting into the language / less experienced and thus reduce the
level of difficulty in the documentation. ie: Make it more
verbose, less technical, friendlier.
