> Isn't that what the official documentation is?

Not really.  A reference should be coherent and well-organized.

I kind of suspect that part of the problem is that no one really knows
how the system works.  I've run across several diagrams of the
application state flow, for instance, and most are clearly wrong --
stupid things like confusing states and transitions, and more complex
things like major inconsistencies between the diagrams (those that are
at least structurally valid) and the descriptions.  And descriptions
(no diagrams that I've found) of the Intent resolution algorithm are
similarly inconsistent.

I've learned Basic, APL, Pascal, Modula 2, PL/I, COBOL, Java, and
(gag) RPG (plus about eight different assembly languages) all by
reading the reference manuals.  (Only programming class I ever took
was FORTRAN.)  Learned DOS internals reading the pubs and Qt for
Symbian by reading the online documentation.  And of all of those
(except maybe RPG) Android is by far the worst in terms of the
coherence and usability of the documentation.

On Sep 14, 12:40 pm, 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