On Mar 18, 10:38 pm, Megha Joshi <[email protected]> wrote: > Thanks for your feedback in helping us improve our Android developer > resources.
One of the suggestions is to take user-contributed articles (and filter out the poorly-written/incorrect ones). This is an excellent idea - I'm sure many people would be willing to write such articles. Another way of allowing developers to contribute to the documentation would that would be amazing is to add a comments system to the reference pages. Currently if you see an error in the documentation or want to add something, e.g. an example (these seem to be particularly absent), there is no real way to do so. You could open a bug, or if you're feeling really energetic create a patch, but the chances of either of these being applied to the source are basically zero. A better alternative would be to allow users to comment on the pages. A simple implementation would allow comments at the bottom of each page or section (see the MySQL documentation for a great example of this). Alternatively something like sidewiki, but where the comments are at specific vertical locations might work. Then we can fix this handy list of documentation bugs: http://code.google.com/p/android/issues/detail?id=5958 http://code.google.com/p/android/issues/detail?id=212 http://code.google.com/p/android/issues/detail?id=5957 http://code.google.com/p/android/issues/detail?id=7276 http://code.google.com/p/android/issues/detail?id=7259 http://code.google.com/p/android/issues/detail?id=6680 http://code.google.com/p/android/issues/detail?id=5960 http://code.google.com/p/android/issues/detail?id=6625 http://code.google.com/p/android/issues/detail?id=1856 http://code.google.com/p/android/issues/detail?id=6534 http://code.google.com/p/android/issues/detail?id=6563 http://code.google.com/p/android/issues/detail?id=6940 http://code.google.com/p/android/issues/detail?id=7003 http://code.google.com/p/android/issues/detail?id=1979 (wow this one looks really annoying) http://code.google.com/p/android/issues/detail?id=7314 http://code.google.com/p/android/issues/detail?id=3518 http://code.google.com/p/android/issues/detail?id=6272 http://code.google.com/p/android/issues/detail?id=4183 http://code.google.com/p/android/issues/detail?id=939 (shapes are not even mentioned in the documentation) http://code.google.com/p/android/issues/detail?id=4169 http://code.google.com/p/android/issues/detail?id=6572 Ok so I got carried away, but maybe Google aren't aware of these problems... Thoughts? -- 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 To unsubscribe from this group, send email to android-developers+unsubscribegooglegroups.com or reply to this email with the words "REMOVE ME" as the subject.
