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
