I think this old HN discussion is relevant because it shows that documentation is multifaceted and just one approach doesn't cover everything.

https://news.ycombinator.com/item?id=21289832

I have often seen people complain about auto generated documentation being worse than useless when that is not the case. It's not that the documentation is poor, it's that there is a complete lack of the other 3 kinds of documentation.