Natural Docs Icon

User Ratings

★★★★★
★★★★
★★★
★★
14
0
0
0
0
ease 1 of 5 2 of 5 3 of 5 4 of 5 5 of 5 5 / 5
features 1 of 5 2 of 5 3 of 5 4 of 5 5 of 5 5 / 5
design 1 of 5 2 of 5 3 of 5 4 of 5 5 of 5 5 / 5
support 1 of 5 2 of 5 3 of 5 4 of 5 5 of 5 5 / 5
Write a Review

User Reviews

  • disfunzione
    1 of 5 2 of 5 3 of 5 4 of 5 5 of 5

    Thanks very good project! +

    Posted 06/08/2013
  • blaskrusik1978
    1 of 5 2 of 5 3 of 5 4 of 5 5 of 5

    very good project, thanks!

    Posted 04/06/2013
  • ilya_shl
    1 of 5 2 of 5 3 of 5 4 of 5 5 of 5

    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.

    Posted 03/12/2013
  • joedf
    1 of 5 2 of 5 3 of 5 4 of 5 5 of 5

    Wow! Very nice! :D

    Posted 03/06/2013
  • ianrichardson
    1 of 5 2 of 5 3 of 5 4 of 5 5 of 5

    Recomendo

    Posted 02/15/2013
  • oliverfong
    1 of 5 2 of 5 3 of 5 4 of 5 5 of 5

    works perfectly.

    Posted 01/21/2013
  • jonahday
    1 of 5 2 of 5 3 of 5 4 of 5 5 of 5

    Easy to install and use.

    Posted 12/20/2012
  • gavinpowell
    1 of 5 2 of 5 3 of 5 4 of 5 5 of 5

    small and efficient and gets the job done.

    Posted 11/15/2012
  • blakewells
    1 of 5 2 of 5 3 of 5 4 of 5 5 of 5

    Easy to use and works.

    Posted 09/11/2012
  • dzikes
    1 of 5 2 of 5 3 of 5 4 of 5 5 of 5

    Very nice app :)

    Posted 04/24/2012
  • scout4u
    1 of 5 2 of 5 3 of 5 4 of 5 5 of 5

    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.

    Posted 04/15/2012
  • elibrown
    1 of 5 2 of 5 3 of 5 4 of 5 5 of 5

    Great tool

    Posted 03/22/2012
  • prantl
    1 of 5 2 of 5 3 of 5 4 of 5 5 of 5

    + 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

    Posted 03/17/2012
  • saviourmachine
    1 of 5 2 of 5 3 of 5 4 of 5 5 of 5

    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!

    Posted 07/29/2010