Why I'm hesitating to switch to D

[Walter Bright]

On 6/29/2011 6:12 AM, James Fisher wrote:
> What I'm not convinced of is that Ddoc is has any
> advantage over a generic markup format when it comes to the homepage, associated
> pages (FAQ, acknowledgements, etc.), howtos, or even the language reference.
>   When I look over any of those documents -- lex.dd
> <https://github.com/D-Programming-Language/d-programming-language.org/blob/master/lex.dd>
> to take a random example -- I don't see any semantics that can't be expressed
> even in something as simple as Markdown.  Forcing people to write their howtos
> in Ddoc is asking too much for no good reason.


Ok, so take lex.dd (or another page, pick any) and show how it is so much 
easier, nicer, and more productive to express it using some other markup format.