Getting started with D - Phobos documentation sucks

[Timon Gehr]

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