Comment by pritambaral
11 years ago
Not a .NET dev myself, but I believe Android's documentation is also pretty good. Nevertheless, I can distinctly recall instances when looking at Android's source was necessary/helpful.
11 years ago
Not a .NET dev myself, but I believe Android's documentation is also pretty good. Nevertheless, I can distinctly recall instances when looking at Android's source was necessary/helpful.
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.