News for hackers. Stuff that matters.

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

Re:On Apple's Piss-Poor Documentation by psahgal on Tuesday November 10, 2020 @11:21AM (#25047667)
Based on the Android source code I've seen while working on Android projects, I think a good portion of the Android docs are generated by the inline documentation from the Android open-source project.

But on top of that, Google also produces high-quality long-form guides. Those are first-party guides, found at https://developer.android.com/. (Google maintains the Android developer site.)

[ Parent | on HN ]
Re:On Apple's Piss-Poor Documentation by mtc010170 on Tuesday November 10, 2020 @11:49AM (#25048004)
Ah ok, thanks for the response! I've seen a lot of value in automatically generated docs from inline code. Perhaps that's a key baseline strategy for improvement.

Add then padding that with the long-form guides with concepts and examples.

[ Parent | on HN ]