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 goi
On 28/May/2010 00:23, Jesse Wilson wrote:
> On Thu, May 27, 2010 at 4:04 PM, Joshua Bloch 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."
>
>
>
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 documentation
On Thu, May 27, 2010 at 4:04 PM, Joshua Bloch 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 docs than th
