When comparing YUIDoc vs Dgeni, the Slant community recommends Dgeni for most people. In the question“What is the best documentation generator compatible with gulp?” Dgeni is ranked 2nd while YUIDoc is ranked 3rd. The most important reason people chose Dgeni is:
Clever enought to recognise a description. Which means less thing to write...
Ranked in these QuestionsQuestion Ranking
Pros
Pro Cross-platform
YUIDoc is not available for JavaScript only, it supports every language that has /**/
comment blocks.
Pro Great output
YUIDoc's default theme is very appealing. The output it renders is very readable, searchable and user-friendly.
Pro Live preview
A standalone doc server is included which allows you to easily preview the documentation as it's being written.
Pro no @tag
Clever enought to recognise a description. Which means less thing to write...
Cons
Con The name of the method/class need to be mentioned in the comments
Since YuiDoc only parses comment blocks, it requires the names of the methods to be specified there, ignoring what's outside of the comment block.
Con Missing templates
The docuementation generated is really simple. It does need more elaborated template. A beautiful documentation is more easy to read...
Con No documentation/tutorial
Hard to configure and there is almost no documentation or clear example/tutorial.