<div class="gmail_quote">On Wed, Jun 29, 2011 at 7:46 AM, Jacob Carlborg <span dir="ltr"><<a href="mailto:doob@me.com">doob@me.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<div class="im">On 2011-06-28 23:09, Walter Bright wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
5. I know I suck at web site design, which is why David Gileadi helped<br>
us out by designing the <a href="http://d-programming-language.org" target="_blank">d-programming-language.org</a> look & feel.<br>
</blockquote>
<br></div>
I think it makes it hard when most of the pages are written in DDOC. It doesn't help to attract web designers.<br></blockquote><div><br></div><div>I'd definitely agree with that.  I have no experience with DDOC, but TBH I don't intend to ever have any.  As a general criticism of DDOC, it seems like another reinvented wheel.  Semi-plaintext formats surround us like the plague, and for every use case for documentation, there's a better option.  If you want</div>
<div><ul><li>simplicity, use <a href="http://daringfireball.net/projects/markdown/">Markdown</a>.  Supported everywhere, like GH.</li><li>bulky extensible semantic documentation, use <a href="http://www.docbook.org/">DocBook</a>.  Used by O'Reilly, I'm told.  Presumably that's how <a href="http://book.realworldhaskell.org/">Real World Haskell</a> is maintained as a slick website and an O'Reilly book.</li>
<li>readability, but power and extensibility if required, use <a href="http://docutils.sourceforge.net/">docutils</a>/<a href="http://sphinx.pocoo.org/">Sphinx</a>.  Used for the <a href="http://docs.python.org/py3k/">Python standard library documentation</a>, which, as anyone who has used it knows, is The Best Documentation In The World.</li>
</ul></div><div>That said, I suspect DDOC is now entrenched at least in the stdlib documentation, so maybe we'll have to live with it.  However, the case for <a href="https://github.com/D-Programming-Language/d-programming-language.org/blob/master/index.dd">using it for the website</a> is nonexistent (anyone disagree?).</div>
</div>