[android-developers] Re: What about examples and comments in the Android reference?

2009-10-07 Thread Marc Reichelt

Thanks for the tip, Yusuf!

The examples are nice! But as I said - they aren't at the right place
when one searches the reference.
I have not found these examples until you sent me the link. And again,
if one finds a specific method in the reference he is left alone with
the API reference, and he has to find examples in the Internet on his
own.

Anyway - I hope that the documentation will improve as the SDK does. I
also think there is a way to integrate Android developers, e.g. by
using a Wiki-like system.

Regards

Marc Reichelt   ||   http://www.marcreichelt.de/


On 6 Okt., 23:01, Yusuf Saib (T-Mobile USA) yusuf.s...@t-
Mobile.com wrote:
 Good point. FWIW, many people find the API demos 
 useful:http://developer.android.com/guide/samples/ApiDemos/index.html

 Yusuf Saib
 Android
 ·T· · ·Mobile· stick together
 The views, opinions and statements in this email are those of the
 author solely in their individual capacity, and do not necessarily
 represent those of T-Mobile USA, Inc.

 On Oct 6, 6:07 am, Marc Reichelt mcreich...@googlemail.com wrote:

  Hi there!

  I have been using the Android documentation for a few days now, and it
  is quite good and easy to read.
  Apart from that I noticed that I missed something, and now I found out
  what it is:
      Examples and comments.

  If you look at the PHP documentation 
  (e.g.http://www.php.net/manual/en/function.substr.php
  for the PHP substr() function) you will see many syntax-highlighted
  examples and comments by users.

  Of course there are examples in the Android documentation, especially
  in the Dev Guide category - they just are not at the right place if
  one searches the reference for a specific method or functionality.
  What do you think about this?

  @Google Team: I believe this means more work, but I also believe that
  it would improve the reference by all means. Maybe there is a
  compromise: The offline reference just contains the examples and
  hyperlinks guide to the online documentation for those who are looking
  for user comments.

  Regards

  Marc Reichelt   ||  http://www.marcreichelt.de/
--~--~-~--~~~---~--~~
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: What about examples and comments in the Android reference?

2009-10-06 Thread Yusuf Saib (T-Mobile USA)

Good point. FWIW, many people find the API demos useful:
http://developer.android.com/guide/samples/ApiDemos/index.html


Yusuf Saib
Android
·T· · ·Mobile· stick together
The views, opinions and statements in this email are those of the
author solely in their individual capacity, and do not necessarily
represent those of T-Mobile USA, Inc.




On Oct 6, 6:07 am, Marc Reichelt mcreich...@googlemail.com wrote:
 Hi there!

 I have been using the Android documentation for a few days now, and it
 is quite good and easy to read.
 Apart from that I noticed that I missed something, and now I found out
 what it is:
     Examples and comments.

 If you look at the PHP documentation 
 (e.g.http://www.php.net/manual/en/function.substr.php
 for the PHP substr() function) you will see many syntax-highlighted
 examples and comments by users.

 Of course there are examples in the Android documentation, especially
 in the Dev Guide category - they just are not at the right place if
 one searches the reference for a specific method or functionality.
 What do you think about this?

 @Google Team: I believe this means more work, but I also believe that
 it would improve the reference by all means. Maybe there is a
 compromise: The offline reference just contains the examples and
 hyperlinks guide to the online documentation for those who are looking
 for user comments.

 Regards

 Marc Reichelt   ||  http://www.marcreichelt.de/
--~--~-~--~~~---~--~~
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
-~--~~~~--~~--~--~---