Comment by ygra

Having done a lot of C# and Java (both of which are very well documented) in the past and a little bit of Android development recently, I cannot confirm that. The documentation is a horrible mess of a few helpful things (most longer texts introducing platform quirks and intricacies are useful), barely documented things (many, many parts of the class libraries) and downright undocumented things (styles, where the "documentation" even tells you to read the source). (Not to mention the plethora of typos and misspellings in the official docs.)

Generally I've not been very impressed with the quality of Android's documentation and firmly believe a company such as Google can do better. And after having a look at the process around getting a patch approved I deemed it not worth my time trying to contribute documentation fixes and enhancements.