A great idea. I too think you should leverage the existing community to build up the knowledgebase and improve general documentation quality. Using Google, etc., it's sometimes very hard to figure out what information is still valid, what's obsolete, and what's strictly wrong. (It's for this reason that I started writing things down at www.androidref.com, because it took me a number of different site visits to figure some things out.)
Having a central location for facts and learned knowledge would be incredibly useful. Jay On Mar 23, 6:47 am, Tim <[email protected]> wrote: > 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=5958http://code.google.com/p/android/issues/detail?id=212http://code.google.com/p/android/issues/detail?id=5957http://code.google.com/p/android/issues/detail?id=7276http://code.google.com/p/android/issues/detail?id=7259http://code.google.com/p/android/issues/detail?id=6680http://code.google.com/p/android/issues/detail?id=5960http://code.google.com/p/android/issues/detail?id=6625http://code.google.com/p/android/issues/detail?id=1856http://code.google.com/p/android/issues/detail?id=6534http://code.google.com/p/android/issues/detail?id=6563http://code.google.com/p/android/issues/detail?id=6940http://code.google.com/p/android/issues/detail?id=7003http://code.google.com/p/android/issues/detail?id=1979(wow > this one > looks really > annoying)http://code.google.com/p/android/issues/detail?id=7314http://code.google.com/p/android/issues/detail?id=3518http://code.google.com/p/android/issues/detail?id=6272http://code.google.com/p/android/issues/detail?id=4183http://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=4169http://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.
