[OT] of [OT] I am a developer and I hate documentation

[karabuta via Digitalmars-d]

On Thursday, 18 August 2016 at 23:14:44 UTC, H. S. Teoh wrote:
> On Fri, Aug 19, 2016 at 12:02:09AM +0200, Marco Leise via 
> Digitalmars-d wrote: [...]
>> By the way, AFAIK someone implemented `code` as an alternative 
>> to $(D code) quite a while ago. So you can use that instead.  
>> I'd like ordered/unordered lists to also follow markup style 
>> one day. I find it more natural and readable than
>> 
>> $(OL
>>   $(LI first item)
>>   $(LI another important thing)
>> )
> [...]
>
> Sigh.  Eventually we're just reinventing Markdown in ddoc. Why 
> can't we just use Markdown (with some ddoc extensions) in the 
> first place?
>
>
> T

That will be way better, don't know why markdown is not used 
already.

.....

Cant imagine how a compiler generated documentation for D 
templates will look like :)