Absolutely you shouldn't release new APIs unless you've had time to document 
them properly. Suggesting that releasing APIs is more important than 
documenting them is nothing short of absurd. Documentation is one of the 
most critically important aspects of any software platform and Android's is 
just plain bad. If your APIs aren't fully documented then they aren't 
finished and absolutely are not in a releasable state. Pushing them out on 
the world without proper documentation is irresponsible and causes serious 
harm to the platform.

As an example of how important good documentation is: Google claims that 
third party apps will behave correctly across all the different manufacturer 
skins as long as the developers don't use any undocumented calls. Well, when 
virtually nothing is documented in a satisfactory way that leaves us with an 
unusable and hopelessly fragmented platform, wouldn't you say?

Take some time off on the new features for a while and document everything 
that's already there thoroughly and completely. Augment that documentation 
with good sample code and tutorials. What you lose in new platform features 
you will gain back tenfold in the form of an exponential leap forward in the 
quality of third party apps. The tools to make amazing apps are all there 
already, but nobody can figure out how to use them! When developers spend as 
much as half their time spinning their wheels trying to figure out why 
something doesn't work because the documentation is incomplete or 
inaccurate, that's a lot less time they can spend bringing the quality of 
the app up to par with what they can accomplish on other platforms in the 
same time. The importance of complete and high quality documentation just 
can't be overstated, and Google needs to start taking it seriously.

-- 
You received this message because you are subscribed to the Google
Groups "Android Developers" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/android-developers?hl=en

Reply via email to