When comparing dox vs Spinx-js, the Slant community recommends dox for most people. In the question“What are the best documentation generators for Node.js apps?” dox is ranked 4th while Spinx-js is ranked 5th. The most important reason people chose dox is:
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 `...`
Ranked in these QuestionsQuestion Ranking
Pros
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 ...
Pro Friendly interface
Quick involvement in documentation
Pro Automatic testing of code snippets
Also, inclusion of docstrings from Python modules (API docs)
Pro You can write documentation that describes things. Tutorial like. Unlike JSDocs which is only for APIs
Pro A tool that is used in many projects
Cons
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.
Con Not quite as simple as JSDoc
Con Some plug ins have poor quality
Sphinx is an open source project, while the main project is actively maintained, some plug-ins developed by volunteers are not maintained.