Newbie feedback

[Sylvain]

Hi all,

I'm a newbie to python (i develop a little with C# and Java) but i
wanted to test this new service, so i've tried to make a TinyURL
clone, yes another one :) : http://yatuc.appspot.com

Python is not really difficult to learn/understand but i've lost a lot
of time with the documentation (certainly because i'm a newbie ;) ) :
here are the things i'd like to see in the doc :

-1- how to configure an editor in order to have auto-completion, break
point (possible ??), step-by-step (possible ??). I found a doc in this
group to configure pydev+eclipse (thanks !). GWT and Android have both
this in the SDK.

-2- the webapp framework is a mixture of pure GAE, WebOb and
Django,... In order to create a template, get parameters, etc,... i've
to jump from a site to another one...

All functions, class,... from these namespaces should be described in
the GAE doc.

from google.appengine.ext.webapp import template
from google.appengine.ext import webapp

Maybe my pydev was not well setup but the autocompletion does not work
very well, example : self.request.(??) , the info is on the WebOb
website.

-3- Autocompletion is really nice but sometime really distrubing,
example : def post(self): self.get_url(cls) , get_url is not describe
in the doc , users.get_current_user() or users.GetCurrentUser() : why
2 functions ?

-4- All arguments should be explained : class
StringProperty(verbose_name=None, multiline=False, ...) What does it
mean : "..." ? ,get(*args) *args could be explained

In conclusion, GAE is great but to jump from Java, C#,.. to py, i
think the documentation should be easier to understand for beginnners
and particularly the template/webapp framework.

Regards.