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.
