|
Size: 875
Comment:
|
Size: 1805
Comment: documentation overview
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| A guide and a discussion page for PythonDocumentation. | Documentation for Python and related libraries falls into a variety of categories. The first that most users encounter is the ''standard documentation'', which can be found in a variety of places. |
| Line 3: | Line 5: |
| Beginners: * [http://www.python.org/doc/Newbies.html Python for Beginners] * MovingToPythonFromOtherLanguages |
== Standard Documentation == |
| Line 7: | Line 7: |
| Other: * [http://www.python.org/doc/ Documentation Central] * FrequentlyAskedQuestions |
The standard documentation for the most recent stable release of Python can always be found at http://docs.python.org/. It's easy to search that version using Google; the search box at the top of the page on that site will perform a Google search of only that site. Downloadable versions for printing and interactive use are also made available at that location. |
| Line 11: | Line 13: |
| ---- '''Discussion:''' |
Older versions of the standard documentation are kept available as well, since many users have to maintain code for older versions of the interpreter as well. These can be found at http://www.python.org/doc/versions.html. |
| Line 14: | Line 17: |
| Please!! get a wiki running side-by-side with the docs eg: 1 corresponding wikiable page for every page here in the pydocs. The startup data is simply that of the docs, so just mirror their structure. Then after the wiki docs start offering lots of useful information, the actual doc writers can incorporate this. To summarize, I think Python's documentation (like the library reference) is basically a big melange of api data and some snippets of useful info. This wiki will help replace those places that just use API data to fill up space, and turn it into something better. | == Published Books == There are a range of PythonBooks that have been published in printed forms by a variety of commercial publishers. These range from introductory material on programming using Python as an example language to in-depth treatments of specific topics from a Python programmer's perspective. Look for them at your favorite bookseller, or check them out from your local public or university library. == Alternate Introductory Documentation == Additional introductory and tutorial materials are also available; a list of pointers is maintained at http://www.python.org/doc/Intros.html. == Non-English Documentation == There are a number of documents and other resources available for Python users in languages other than English. These include translations of standard and third-party documents as well as original documents written in other languages. A list of these is maintained at http://www.python.org/doc/NonEnglish.html. |
Documentation for Python and related libraries falls into a variety of categories. The first that most users encounter is the standard documentation, which can be found in a variety of places.
Standard Documentation
The standard documentation for the most recent stable release of Python can always be found at http://docs.python.org/. It's easy to search that version using Google; the search box at the top of the page on that site will perform a Google search of only that site. Downloadable versions for printing and interactive use are also made available at that location.
Older versions of the standard documentation are kept available as well, since many users have to maintain code for older versions of the interpreter as well. These can be found at http://www.python.org/doc/versions.html.
Published Books
There are a range of PythonBooks that have been published in printed forms by a variety of commercial publishers. These range from introductory material on programming using Python as an example language to in-depth treatments of specific topics from a Python programmer's perspective. Look for them at your favorite bookseller, or check them out from your local public or university library.
Alternate Introductory Documentation
Additional introductory and tutorial materials are also available; a list of pointers is maintained at http://www.python.org/doc/Intros.html.
Non-English Documentation
There are a number of documents and other resources available for Python users in languages other than English. These include translations of standard and third-party documents as well as original documents written in other languages. A list of these is maintained at http://www.python.org/doc/NonEnglish.html.