Why D is annoying =P

[Jacob Carlborg]

On 2012-10-30 17:09, Tobias Pankrath wrote:

> I agree, that the online docs are insufficient for learning the
> language.
> But that's the case for phobos, too. Both are just a listings of
> what is there and don't give you any overview of what design
> decisions were made and what implications they have.
>
> Just take a look std.container.
>
> I hope that Ali Çehreli efforts will be midterm solution at
> least for the language docs. Maybe he should credits by linking
> from the homepage to his book.

A language needs several types of documentation. Reference documentation 
(basically what we have now), higher level documentation, tutorials and 
examples.

-- 
/Jacob Carlborg