I think this old HN discussion is relevant because it shows that documentation i...

		imtringued on Nov 10, 2020 \| parent \| context \| favorite \| on: On Apple's Piss-Poor Documentation 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.

Big agree, although I think in this case even the auto-generated stuff being talked about is awful.