On Thu, Apr 16, 2009 at 4:49 PM, a druid <klausf...@gmail.com> wrote:
> > Hi David, > > I do not talk about the documentation on the web. > Ah sorry about that. > > The documentation packaged with the 1.5. release is wrong as well. > If the doc is wrong in any case it might be better to provide a > doc.html, > which states. > > > This is a pre-release. > > Don't expect to find any useful documentation here. > > If you're relally interested in the documentation of the > > previous release, then click 'here' > > > I still think this would be better than providing bad documentation > without any comments. > I agree with you, but I can only assume that doing this was going to be a risky change to the SDK generation script, and that it was just easier to package the stuff as-is for the preview. > > > On Apr 16, 4:43 pm, David Turner <di...@android.com> wrote: > > The documentation on the official web site is still for 1.1 > > As as been announced, we will update the site when we release the final > 1.5 > > SDK > > > > It's a "preview" for a reason :-) > > > > On Thu, Apr 16, 2009 at 4:24 PM, a druid <klausf...@gmail.com> wrote: > > > > > Hi, > > > > > Well I know, that this is just a pre-release bla . bla . bla, > > > but still this doesn't justify everything. > > > > > Wouldn't it be nice to have the documentation at least halfways > > > accurate? > > > Or if it's not accurate to add at some kind of 'obsolete' marker to > > > certain chapters. > > > This can be done very quickly and helps users. > > > > > The very first thing I looked up was docs/guide/developing/other- > > > ide.html > > > > > Creating an Android project still talks about "activityCreator" , > > > which doesn't exist any more. > > > > > Additionally the example still talks about activityCreator.py (which > > > didn't even exist in the previous release under linux) > > > > > My suggestion to the Google team would be to at least mark all > > > chapters as obsolete, which might have to be rewritten. > > > If the document changes are already known, the obsolete marler could > > > already point to some kind of release notes file with the anticipated > > > changes. > > > > > In my example this could have been a reference to > > >http://developer.android.com/sdk/preview/ > > > "Where is activitycreator" > > > > > I think this suggestion might help to get rid of quite some un > > > necessary support questions. > > > > > > > --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Android Developers" group. To post to this group, send email to android-developers@googlegroups.com To unsubscribe from this group, send email to android-developers-unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/android-developers?hl=en -~----------~----~----~----~------~----~------~--~---
