Worst Phobos documentation evar!

[Ary Borenszweig via Digitalmars-d]

On 12/31/14 7:46 PM, Dicebot wrote:
> On Wednesday, 31 December 2014 at 22:41:41 UTC, Ary Borenszweig wrote:
>> You are right. I browsed some phobo's code and saw the documentation,
>> it looks clean and nice. The only exception is std.algorithm which is
>> full of macros and barely readable.
>>
>> So where is that other macro code? The one that has $(BLANKLINE) or
>> $(COMMA) or $(DASH) and why is it needed?
>
> IMHO biggest issue is not inline documentation for functions but more
> higher level stuff like http://dlang.org/arrays.html - it was all in
> DDOC too last time I checked and changing anything about it is hardly a
> pleasure. Inline documentations only suffers when more pretty stuff like
> tables gets added.

It looks quite clean to me:

https://github.com/D-Programming-Language/dlang.org/blob/master/arrays.dd

Except for the fact that instead of the familiar HTML tags there are 
macros. I see macros for:

Paragraphs: $(P)
Lists: $(UL), $(LI)
Links: $(HTTP)

These are very, very, veeeery common in documentation and sites. 
Couldn't DDoc provide nice, readable ways for dealing with these?