On 3/13/15 2:02 PM, Almighty Bob wrote:
The language reference is pretty abysmal too. EG...
The language "Introduction" spends all it's time talking about phases of
compilation. That's like introducing someone to driving by explaining
how the internal combustion engine works.
The page on templates starts with scope and instantiation details. The
examples at the start have alias parameters which aren't explained until
half way down the page.
I mean why no start the template page with something that people will
find familiar and then build on that?
It has that feel all the way through. You go looking for things and they
never seem to be where you expect, or they are so tersely explained, it
feels like it's a reference for people already experts in D. Which is
fine if that's what it's meant to be ... but if you want to attract new
people you need a "guided tour" rather than a "technical spec".
The language reference is fine if arid. One shouldn't learn the language
from its reference. It should be, however, complemented by tutorials. --
Andrei
