News for hackers. Stuff that matters.
Re:On Apple's Piss-Poor Documentation by mtc010170 on Tuesday November 10, 2020 @11:09AM (#25047526)
I'm curious who maintains the Android docs. Is it all open source? Is any of Apples?
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.)

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.