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

