Confluence has nailed this product for engineering companies. So far I haven't seen anything that beats it.

Generated doc tools like Javadoc/Yard are usually terrible and only good for very specific documentation use cases. If that's all a codebase has, it's a middle finger to developers.