On 09/29/2012 05:30 PM, Mr. Anonymous wrote:
Hi guys.
I was browsing the book "Programming in D" by Ali Çehreli. It was pretty
much clear, and then I stumbled upon this on page 89:
20.9 Exercises
1. Browse the documentations of the std.string, std.array,
std.algorithm, and std.range modules.
OK, let's open the D website and browse the documentation of std.string:
http://dlang.org/phobos/std_string.html
What do we see? A bunch of links that look like SEO tags of a spam
website, followed by a mess of anything - structs, classes, functions,
and what not.
Do you really think somebody who learns programming can understand
anything here?
Compare this with, e.g., an msdn reference:
http://msdn.microsoft.com/en-us/library/windows/desktop/ms684852(v=vs.85).aspx
A clear division of enums, functions, macros, structs, ...
http://msdn.microsoft.com/en-us/library/windows/desktop/ms684847(v=vs.85).aspx
The functions are divided by usage, with a short explanation next to
each function.
I think documentation is really important, and something has to be done
about it. How can a newcomer get started with D when he doesn't have a
readable documentation of Phobos?
https://github.com/D-Programming-Language/d-programming-language.org
