Natural Docs Reviews

Fantastic, I've used it to generate really good looking documentation for various languages

Highly recommended. Lets you document concepts and logical types, as opposed to only the physical types. This is in contrast to Doxygen, which focuses on the physical types. Also, the comments in the code (where you read them most of them time) are much less cluttered and look more natural than with other systems. On the minus side, unlike Doxygen it does not do full syntax parsing of C++; and the fact that each function has a prototype and a definition creates duplicate topics if you document both. Also, single-file PDF documentation cannot be generated (though you could use some tool to convert the HTML website to a single PDF). On balance, this is my documentation system of choice. Many thanks to the author, hope he continues improving it.

Wow! Very nice! :D

Very nice app :)

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

A really nice-looking alternative for doxygen. I have been looking for css stylesheets for the former, but didn't find anything that looked as nice as Natural Docs. A minor downside, a lot of comments in our C/C++ code base are already in doxygen format. Progress doesn't seem to be slow to support this (only C#). More programmers need to join!!! Thanks a lot!