On 28/May/2010 00:23, Jesse Wilson wrote:
On Thu, May 27, 2010 at 4:04 PM, Joshua Bloch j...@google.com wrote:
I was a bit surprised to see efforts being made to improve Android docs.
The previous common wisdom had been ignore them; everyone with any sense
will read JDK JavaDocs instead.
indeed. or as we've been saying tutorial versus quick reference
versus specification. i've been erring in favor of quick reference:
aiming at people who know what they're doing, but need their memory
jogged.
the other thing i consider important, which i think Sun was always
very bad at, is going
On Thu, May 27, 2010 at 4:04 PM, Joshua Bloch j...@google.com wrote:
I was a bit surprised to see efforts being made to improve Android docs.
The previous common wisdom had been ignore them; everyone with any sense
will read JDK JavaDocs instead.
The new goal of our team is, write better
it turned out that developers are using our documentation because they
need to use it for the Android-specific classes, and it's just
convenient for them to get all their documentation from the same
place. plus a large proportion of external bugs are basically only
solvable via better