Hey Ben,

Great post and if I can help in any way let me know. :-)

Re: your questions...

I'd like some input from you guys, though!

1) I was thinking an interactive page where you can run all of the
demos without having to click in, and even edit the code inline and
see the changes.

- I like it! It would be great to be able to click a link for a demo,
see it in action, click edit code and play with the code, yes! much
like the W3Schools one and the Gadget Editor to some degree.


2)  And what about the difficulty of the demos?  Would it be more
helpful to have very bare-bones basic samples that show very common
uses that users ask or would you want to see mini-sample applications
that actually achieve some goal?

-  Some of each (more focus on the getting started though), I like
apps/demos that actually have a practical application, but there needs
to be the basic "hello world" ones to get people started, but I would
still like to see more advanced ones too (and using them/integration
with other APIs). I would like to see them organized by API category
and possibly have a star/icon to indicate difficulty level. I also
agree with the one post that the code should be well documented
explaining different api concepts. It may be helpful to have a section
of most commonly asked questions ones.


3) And lastly, should there be one page for all of the AJAX API demos
or separate pages for each individual API?

- As things grow it may need to change a bit, but a 'one stop shop'
for the examples would be great, could be an AJAX type interface,
click the section/category and it returns the samples (and
descriptions) for that section.

Hope that helps :-)

Cheers!
Vision Jinx

On Oct 17, 3:04 pm, "Ben Lisbakken" <[EMAIL PROTECTED]> wrote:
> Hey all --
> I've been looking through the samples and we have a decent amount.  The only
> problem is that they're spread out and sometimes hard to find.  Also, it's
> kind of a mix-and-match whether the samples are very low-level and easy to
> understand or whether they take a bit of involved thinking.
>
> I've been toying with the idea of creating a page like the Maps API has like
> this:http://code.google.com/apis/maps/documentation/flash/examples/index.html
>
> I'd like some input from you guys, though!  I was thinking an interactive
> page where you can run all of the demos without having to click in, and even
> edit the code inline and see the changes.  And what about the difficulty of
> the demos?  Would it be more helpful to have very bare-bones basic samples
> that show very common uses that users ask or would you want to see
> mini-sample applications that actually achieve some goal?
>
> And lastly, should there be one page for all of the AJAX API demos or
> separate pages for each individual API?
>
> Please discuss.
>
> -Ben
>
> p.s. contributers welcome!
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"Google AJAX APIs" 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/Google-AJAX-Search-API?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to