Worst Phobos documentation evar!

Dicebot via Digitalmars-d digitalmars-d at puremagic.com
Mon Dec 29 14:38:18 PST 2014


On Monday, 29 December 2014 at 22:35:50 UTC, Walter Bright wrote:
> On 12/29/2014 12:02 PM, Jacob Carlborg wrote:
>> On 2014-12-29 20:47, Walter Bright wrote:
>>
>>> It uses something pretty similar. They all kinda mush 
>>> together in my
>>> mind :-(
>>
>> Don't blame Markdown just because some other markup language 
>> you don't like
>> looks similar to you.
>
> Why I don't like Markdown:
>
> "Markdown is not a replacement for HTML, or even close to it. 
> Its syntax is very small, corresponding only to a very small 
> subset of HTML tags."

Which just the thing you need to make good simple documentation. 
DDOC suffers a lot from being generic macro language - it is 
simply not specialized enough to be convenient documentation 
markup language.


More information about the Digitalmars-d mailing list