On Friday, 13 March 2015 at 21:02:39 UTC, 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 a reference; it's supposed to be a
technical spec, not a starting point. That said, the only links
to starting points are the book (which isn't free) and the
"Programming in D" pages at
http://ddili.org/ders/d.en/index.html (which are now buried in
the Articles tab)
