Worst Phobos documentation evar!

[Ary Borenszweig via Digitalmars-d]

On 12/30/14 3:57 PM, ketmar via Digitalmars-d wrote:
> On Tue, 30 Dec 2014 13:18:05 +0000
> Russel Winder via Digitalmars-d <digitalmars-d at puremagic.com> wrote:
>
>> Markdown is inadequate for more than single page HTML
> which is exactly what API reference documentation is! a list of
> functions with explanations, some samples and a brief overview. this is
> why markdown-like language is a good choice. stop writing Charles
> Dickens' novels in source code, please! ;-)
>

Yes, exactly. If you need to add special HTML beyond what Markdown 
offers you, then you are doing it wrong.

My question is: why D docs need more that the basics?