It's not a valid excuse that Android is "open source". I assume that
Google wants to make Android extremely successful, at least as much as
other "free"/"open source" products it offers. Look at Google Maps; it
has an open API as well.

Writing, maintaining, and updating documentation may be boring and
tedious for engineers, but I have to assume that it isn't for
technical writers who are paid to do it. I assume that Google has
technical writers working on the Android SDK documentation, unless
they have a bunch of engineers who are doing nothing but
documentation.

I have to hope that Google won't be offended by complaints about
documentation, and that instead they'll want to improve it. Having
said that, it's like software; the best feedback provides specific
examples where the documentation is not sufficing. Of course, maybe
you can't provide anything more than "I am confused, and the
documentation isn't helping" or "It takes too long, and the
documentation isn't helping".

I haven't developed for iOS, but if developers think that iOS apps are
easier to develop and that the documentation is part of this, then
maybe Google will listen to that criticism and take a look at the iOS
documentation.

A. Elk (the brontosaurus is thinner at one end...)

On Sep 14, 10:40 am, TreKing <[email protected]> wrote:
> On Tue, Sep 14, 2010 at 12:31 PM, DanH <[email protected]> wrote:
> > I'm not sure why there's such a dearth of good Android documentation
>
> Probably because writing, maintaining, and updating documentation is a
> boring, tedious job.
>
> > especially given that what I'd like most is a good basic reference (which
> > would normally be the first thing written), vs some sort of hand-holding
> > tutorial.
>
> Isn't that what the official documentation is?
>
> --------------------------------------------------------------------------- 
> ----------------------
> TreKing <http://sites.google.com/site/rezmobileapps/treking> - Chicago
> transit tracking app for Android-powered devices

-- 
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

Reply via email to