Roberto De Renzi <roberto.dere...@unipr.it> added the comment: Thank you, Eric. My comment was not intended either as a bug (I thought it was the wrong place to post it, but coud not find any better) or a help request. It is just a suggestion.
We non professional progammers happen to be writing code for some time, then stopping, then coming back. Therefore we often vaguely know how to do, but do not remember the syntax well. The best solution is a great reference manual. The reference structure makes the info easy to find, then you want a definition, and an example as well, to clarify the usage. I noticed that the present stage of documentation is not ideal, and , to my understanding, what is lacking most is the simple example part. I will post this on the the python-dev list, as you suggest. Thanks again Roberto Il 21/03/2011 11:36 PM, Ãric Araujo ha scritto: > Ãric Araujo<mer...@netwok.org> added the comment: > > Welcome to Python! We hope youâll have a great time using it. > > The language reference is useful to understand subtleties or implement a > Python interpreter, not for common use. The library reference is, well, a > reference manual to use when you already know the modules. Another resource > with more examples is http://www.doughellmann.com/PyMOTW/articles/. > SilentGhost gave you the link to the official tutorial; more links are given > on http://wiki.python.org/moin/FrontPage. If you still have questions, the > python-list mailing list or #python IRC channel are full of nice people with > answers. > > I hope those links get you started in the right direction. Since this report > does not contain a specific error in the Python doc, I am closing it. > > If you want to suggest the policy of adding short examples to all our docs, > please bring it up to the python-dev mailing list. > > ---------- > assignee: docs@python -> > nosy: +eric.araujo > resolution: -> works for me > stage: -> committed/rejected > status: open -> closed > > _______________________________________ > Python tracker<rep...@bugs.python.org> > <http://bugs.python.org/issue11622> > _______________________________________ ---------- Added file: http://bugs.python.org/file21331/roberto_derenzi.vcf _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue11622> _______________________________________
<<attachment: roberto_derenzi.vcf>>
_______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
