Here's looking at you, kid

[Saurabh Das via Digitalmars-d]

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.