<div class="gmail_quote">On Wed, Jun 29, 2011 at 10:59 AM, Don <span dir="ltr"><<a href="mailto:nospam@nospam.com">nospam@nospam.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
Chris Molozian wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
  I very much agree. When it comes to lightweight markup languages for use in web (and more) templating there's: Markdown <<a href="http://daringfireball.net/projects/markdown/" target="_blank">http://daringfireball.net/<u></u>projects/markdown/</a>>, Markdown Extra <<a href="http://michelf.com/projects/php-markdown/extra/" target="_blank">http://michelf.com/projects/<u></u>php-markdown/extra/</a>>, Haml <<a href="http://haml-lang.com/" target="_blank">http://haml-lang.com/</a>>, Textile <<a href="http://textile.thresholdstate.com/" target="_blank">http://textile.<u></u>thresholdstate.com/</a>>... to name just a few. Is it worth maintaining another tool?<br>

<br>
When it comes to documentation within source files couldn't D adopt one of the many different <<a href="http://en.wikipedia.org/wiki/Comparison_of_documentation_generators" target="_blank">http://en.wikipedia.org/wiki/<u></u>Comparison_of_documentation_<u></u>generators</a>>documentation generators? <br>

</blockquote>
<br>
Look at how many of those tools support D.<div class="im"><br>
<br>
> Again wouldn't that mean less custom tools to maintain.<br>
<br></div>
I doubt it. The source for DDoc is only 2000 lines of code (and it's simple code). D has enough unique features that you need to fight with your document generation system, if it doesn't natively support D.</blockquote>
<div><br></div><div>Perhaps we should drop the "what's better than DDOC" issue for the moment.  The real issue is relegating it to where it belongs, which is (surprise) documenting D code.  Which means separating out the stdlib documentation on <a href="http://d-programming-language.org">d-programming-language.org</a> from ... everything else, in the tradition of</div>
<div><ul><li><meta http-equiv="content-type" content="text/html; charset=utf-8"><a href="http://python.org/">http://python.org/</a> vs <meta http-equiv="content-type" content="text/html; charset=utf-8"><a href="http://docs.python.org/">http://docs.python.org/</a></li>
<li><meta http-equiv="content-type" content="text/html; charset=utf-8"><meta http-equiv="content-type" content="text/html; charset=utf-8"><a href="http://www.ruby-lang.org/en/">http://www.ruby-lang.org/</a> vs <a href="http://www.ruby-doc.org/stdlib/">http://www.ruby-doc.org/</a></li>
<li><meta http-equiv="content-type" content="text/html; charset=utf-8"><a href="http://www.perl.org/">http://www.perl.org/</a> vs <meta http-equiv="content-type" content="text/html; charset=utf-8"><a href="http://perldoc.perl.org/">http://perldoc.perl.org/</a></li>
<li><meta http-equiv="content-type" content="text/html; charset=utf-8"><a href="http://nodejs.org/">http://nodejs.org/</a> vs <meta http-equiv="content-type" content="text/html; charset=utf-8"><a href="http://nodejs.org/docs/v0.4.8/api/">http://nodejs.org/docs/v0.4.8/api/</a></li>
<li>and others.</li></ul><div>This thread is flitting between topics, for reasons that are entirely my own.  Perhaps new threads would be appropriate for:</div></div><div><ul><li>Separating <a href="http://d-programming-language.org">d-programming-language.org</a> from <a href="http://docs.d-programming-language.org">docs.d-programming-language.org</a></li>
<li>D brand identity</li><li>Package management.</li></ul></div></div>