[android-developers] Re: why is the sdk 1.5 prerelease releaed with obsolete documentation?
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 -~--~~~~--~~--~--~---
[android-developers] Re: why is the sdk 1.5 prerelease releaed with obsolete documentation?
Hi David, I do not talk about the documentation on the web. 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. 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 -~--~~~~--~~--~--~---
[android-developers] Re: why is the sdk 1.5 prerelease releaed with obsolete documentation?
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 -~--~~~~--~~--~--~---