When comparing Docco vs dox, the Slant community recommends Docco for most people. In the question“What are the best documentation generators for Node.js apps?” Docco is ranked 2nd while dox is ranked 4th. The most important reason people chose Docco is:
Since Docco doesn't enforce any comment style or rules, it's great for beginners who can instantly pick up without having to learn any new syntax or style.
Ranked in these QuestionsQuestion Ranking
Pros
Pro Great for beginners
Since Docco doesn't enforce any comment style or rules, it's great for beginners who can instantly pick up without having to learn any new syntax or style.
Pro Markdown support
All the comments are run through a markdown parser, while all the code is run through Highlight.js for code highlighting.
Pro Supports all jsDoc tags
dox has built-in support for all jsDoc tags and allows you to specify complex object types including optional flag =
, nullable ?
, non-nullable !
and variable arguments ...
Cons
Con Does not enforce a pattern in writing comments
Since Docco only accepts comment lines starting with double slashes, it does not really enforce any pattern in writing comments, at least not as much as it would if it would use comment blocks. This can bring a huge disparity and even make it harder for Docco to generate good documentation as the project grows larger.
Con Needs to be integrated with another tool to generate readable documentation
dox only generates a JSON representation of the documentation. In order to have a fully readable documentation you need to integrate it with some other library that parses the JSON and returns HTML or markdown.