I'd be happy if the code examples came with comments.

On Sep 14, 10:20 am, Bret Foreman <[email protected]> wrote:
> I think the real problem with the Android documentation is its
> minimalist approach. Google wants to be sure the docs are accurate and
> doesn't want maintenance of them to explode into a huge task. So
> external links to other information sources and code examples (that
> might be in error) are kept to a minimum. This means you can usually
> trust the docs...but it also means you often can't understand them.
>
> Here's one cheap way they could make things a lot better: The SDK
> comes with a big collection of code examples but those are not cross-
> referenced to the docs. I'd like to see the code examples integrated
> with the documents and cross referenced so I can click on a URL in a
> code comment and get to the relevant docs and click on a document
> section to see example code.

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