On Wed, Jun 29, 2011 at 10:59 AM, Don <nos...@nospam.com> wrote: > Chris Molozian wrote: > >> I very much agree. When it comes to lightweight markup languages for use >> in web (and more) templating there's: Markdown < >> http://daringfireball.net/**projects/markdown/<http://daringfireball.net/projects/markdown/>>, >> Markdown Extra >> <http://michelf.com/projects/**php-markdown/extra/<http://michelf.com/projects/php-markdown/extra/>>, >> Haml <http://haml-lang.com/>, Textile <http://textile.** >> thresholdstate.com/ <http://textile.thresholdstate.com/>>... to name just >> a few. Is it worth maintaining another tool? >> >> When it comes to documentation within source files couldn't D adopt one of >> the many different <http://en.wikipedia.org/wiki/** >> Comparison_of_documentation_**generators<http://en.wikipedia.org/wiki/Comparison_of_documentation_generators>>documentation >> generators? >> > > Look at how many of those tools support D. > > > > Again wouldn't that mean less custom tools to maintain. > > 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.
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 d-programming-language.org from ... everything else, in the tradition of - http://python.org/ vs http://docs.python.org/ - http://www.ruby-lang.org/ <http://www.ruby-lang.org/en/> vs http://www.ruby-doc.org/ <http://www.ruby-doc.org/stdlib/> - http://www.perl.org/ vs http://perldoc.perl.org/ - http://nodejs.org/ vs http://nodejs.org/docs/v0.4.8/api/ - and others. This thread is flitting between topics, for reasons that are entirely my own. Perhaps new threads would be appropriate for: - Separating d-programming-language.org from docs.d-programming-language.org - D brand identity - Package management.
