Natural Docs

Easy to use and works.

Would be great if someone who know either Perl and PHP port this tool to PHP. that would start new life of this project. Cause since that tool might apear to be welcome to be used in PHP-applications natively. Even in CMS like modx that stores its snipets in database and then would be possible to generate documentation by processing its contents.

+ Good for documenting of projects that have their code base in multiple languages. Comments from different source files can be put together in a single product and links can be created among all parts. + Great readability of comments. They read as a book without being disturbed by complicated markup. + No need to learn any documentation markup syntax; it is so little that seeing the first comment is enough. + JavaDoc (doxygen too?) is supported to make the switch over easier for existing code. + Very good performance by building incrementally. Who documented .NET by Sandcastle will not believe their eyes :-) - Declaring and using nested scopes (classes, objects) is *very* limited and canbe troublesome when documenting rich frameworks. Technically, I can imagine an improvement here possible without redesigning the tool. - The markup can be felt quite limiting when providing accompanying documenation like programmer's guide if you like to create tables, multi-level lists etc. (The established wiki syntax or the modern Markdown styling offers more while retaining the natural look.) --- Ferda