News for hackers. Stuff that matters.

A comment on On Apple's Piss-Poor Documentation.

Re:On Apple's Piss-Poor Documentation by imtringued on Tuesday November 10, 2020 @03:36PM (#25051559)
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.

[ Parent | on HN ]
Re:On Apple's Piss-Poor Documentation by 1MoreThing on Tuesday November 10, 2020 @09:42PM (#25054980)
Big agree, although I think in this case even the auto-generated stuff being talked about is awful.
[ Parent | on HN ]