kennethreitz/python-guide
1
0
Fork 0
mirror of https://github.com/kennethreitz/python-guide.git synced 2026-06-05 23:00:18 +00:00
Code Issues Packages Projects Releases Wiki Activity

lines less than 80 chars in /intro/

Browse Source
This commit is contained in:
Tomas Thor Jonsson
2012-04-23 19:51:47 +02:00
parent 25b1614707
commit db0f65a24e
3 changed files with 53 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/intro/community.rst
+19 -8
View File
@@ -4,14 +4,17 @@ The Community
BDFL BDFL
---- ----
Guido van Rossum, the creator of Python, is often referred to as the BDFL — the Benevolent Dictator For Life. Guido van Rossum, the creator of Python, is often referred to as the BDFL — the
Benevolent Dictator For Life.
Python Software Foundation Python Software Foundation
-------------------------- --------------------------
The mission of the Python Software Foundation is to promote, protect, and advance the Python programming language, and to support and facilitate the growth of a diverse and international community of Python programmers. The mission of the Python Software Foundation is to promote, protect, and
advance the Python programming language, and to support and facilitate the
growth of a diverse and international community of Python programmers.
`Learn More about the PSF <http://www.python.org/psf/>`_. `Learn More about the PSF <http://www.python.org/psf/>`_.
@@ -19,7 +22,8 @@ The mission of the Python Software Foundation is to promote, protect, and advanc
PEPs PEPs
---- ----
PEPs are *Python Enhancement Proposals*. They describe changes to Python itself, or the standards around it. PEPs are *Python Enhancement Proposals*. They describe changes to Python itself,
or the standards around it.
There are three different types of PEPs (as defined by `PEP1 <http://www.python.org/dev/peps/pep-0001/>`_): There are three different types of PEPs (as defined by `PEP1 <http://www.python.org/dev/peps/pep-0001/>`_):
@@ -27,7 +31,8 @@ There are three different types of PEPs (as defined by `PEP1 <http://www.python.
Describes a new feature or implementation. Describes a new feature or implementation.
**Informational** **Informational**
Describes a design issue, general guidelines, or information to the community. Describes a design issue, general guidelines, or information to the
community.
**Process** **Process**
Describes a process related to Python. Describes a process related to Python.
@@ -45,14 +50,16 @@ There are a few PEPs that could be considered required reading:
A list of 19 statements that briefly explain the philosophy behind Python. A list of 19 statements that briefly explain the philosophy behind Python.
- `PEP257 <http://www.python.org/dev/peps/pep-0257/>`_: Docstring Conventions. - `PEP257 <http://www.python.org/dev/peps/pep-0257/>`_: Docstring Conventions.
Gives guidelines for semantics and conventions associated with Python docstrings. Gives guidelines for semantics and conventions associated with Python
docstrings.
You can read more at `The PEP Index <http://www.python.org/dev/peps/>`_. You can read more at `The PEP Index <http://www.python.org/dev/peps/>`_.
Submitting a PEP Submitting a PEP
~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~
PEPs are peer-reviewed and accepted/rejected after much discussion. Anyone can write and submit a PEP for review. PEPs are peer-reviewed and accepted/rejected after much discussion. Anyone
can write and submit a PEP for review.
Here's an overview of the PEP acceptance workflow: Here's an overview of the PEP acceptance workflow:
@@ -62,7 +69,9 @@ Submitting a PEP
Python Conferences Python Conferences
-------------------------- --------------------------
The major events for the Python community are developer conferences. The two most notable conferences are PyCon, which is held in the US, and its European sibling, EuroPython. The major events for the Python community are developer conferences. The two
most notable conferences are PyCon, which is held in the US, and its European
sibling, EuroPython.
A comprehensive list of conferences is maintained `at pycon.org <http://www.pycon.org/>`_. A comprehensive list of conferences is maintained `at pycon.org <http://www.pycon.org/>`_.
@@ -70,4 +79,6 @@ A comprehensive list of conferences is maintained `at pycon.org <http://www.pyco
Python User Groups Python User Groups
-------------------------- --------------------------
User Groups are where a bunch of Python developers meet to present or talk about Python topics of interest. A list of local user groups is maintained at the `Python Software Foundation Wiki <http://wiki.python.org/moin/LocalUserGroups>`_. User Groups are where a bunch of Python developers meet to present or talk
about Python topics of interest. A list of local user groups is maintained at
the `Python Software Foundation Wiki <http://wiki.python.org/moin/LocalUserGroups>`_.
docs/intro/documentation.rst
+2 -1
View File
@@ -13,7 +13,8 @@ The official Python Language and Library documentation can be found here:
Read the Docs Read the Docs
------------- -------------
Read the Docs is a popular community project, providing a single location for all documentation of popular and even more exotic Python modules. Read the Docs is a popular community project, providing a single location for
all documentation of popular and even more exotic Python modules.
`Read the Docs <http://readthedocs.org/>`_ `Read the Docs <http://readthedocs.org/>`_
docs/intro/learning.rst
+30 -21
View File
@@ -7,14 +7,18 @@ Beginner
Learn Python Interactive Tutorial Learn Python Interactive Tutorial
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Learnpython.org is an easy non-intimidating way to get introduced to python. The website takes the same approach used on the popular `Try Ruby <http://tryruby.org/>`_ website, it has an interactive python interpreter built into the site that allows you to go through the lessons without having to install Python locally. Learnpython.org is an easy non-intimidating way to get introduced to python.
The website takes the same approach used on the popular `Try Ruby <http://tryruby.org/>`_
website, it has an interactive python interpreter built into the site that
allows you to go through the lessons without having to install Python locally.
`Learn Python <http://www.learnpython.org/>`_ `Learn Python <http://www.learnpython.org/>`_
Learn Python the Hard Way Learn Python the Hard Way
~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~
This is an excellent beginner programmer's guide to Python. It covers "hello world" from the console to the web. This is an excellent beginner programmer's guide to Python. It covers "hello
world" from the console to the web.
`Learn Python the Hard Way <http://learnpythonthehardway.org/book/>`_ `Learn Python the Hard Way <http://learnpythonthehardway.org/book/>`_
@@ -22,7 +26,8 @@ This is an excellent beginner programmer's guide to Python. It covers "hello wor
Crash into Python Crash into Python
~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~
Also known as *Python for Programmers with 3 Hours*, this guide gives experienced developers from other languages a crash course on Python. Also known as *Python for Programmers with 3 Hours*, this guide gives
experienced developers from other languages a crash course on Python.
`Crash into Python <http://stephensugden.com/crash_into_python/>`_ `Crash into Python <http://stephensugden.com/crash_into_python/>`_
@@ -30,8 +35,8 @@ Also known as *Python for Programmers with 3 Hours*, this guide gives experience
Dive Into Python 3 Dive Into Python 3
~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~
Dive Into Python 3 is a good book for those ready to jump in to Python 3. It's a Dive Into Python 3 is a good book for those ready to jump in to Python 3. It's
good read if you are moving from Python 2 to 3 or if you already have some a good read if you are moving from Python 2 to 3 or if you already have some
experience programming in another language. experience programming in another language.
`Dive Into Python 3 <http://diveintopython3.ep.io/>`_ `Dive Into Python 3 <http://diveintopython3.ep.io/>`_
@@ -39,16 +44,18 @@ experience programming in another language.
Think Python: How to Think Like a Computer Scientist Think Python: How to Think Like a Computer Scientist
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Think Python attempts to give an introduction to basic concepts in computer science through the Think Python attempts to give an introduction to basic concepts in computer
use of the python language. The focus was to create a book with plenty of exercises, minimal jargon and science through the use of the python language. The focus was to create a book
a section in each chapter devoted to the subject of debugging. with plenty of exercises, minimal jargon and a section in each chapter devoted
to the subject of debugging.
While exploring the various features available in the python language the author weaves in various design While exploring the various features available in the python language the
patterns and best practices. author weaves in various design patterns and best practices.
The book also includes several case studies which have the reader explore the topics discussed in the book The book also includes several case studies which have the reader explore the
in greater detail by applying those topics to real-world examples. Case studies include assignments in GUI topics discussed in the book in greater detail by applying those topics to
and Markov Analysis. real-world examples. Case studies include assignments in GUI and Markov
Analysis.
`Think Python <http://greenteapress.com/thinkpython/html/index.html>`_ `Think Python <http://greenteapress.com/thinkpython/html/index.html>`_
@@ -56,13 +63,14 @@ and Markov Analysis.
Python Koans Python Koans
~~~~~~~~~~~~ ~~~~~~~~~~~~
Python Koans is a port of Edgecase's Ruby Koans. It uses a test-driven approach, q.v. TEST DRIVEN DESIGN SECTION Python Koans is a port of Edgecase's Ruby Koans. It uses a test-driven
to provide an interactive approach, q.v. TEST DRIVEN DESIGN SECTION to provide an interactive tutorial
tutorial teaching basic python concepts. By fixing assertion statements that fail in a test script, this teaching basic python concepts. By fixing assertion statements that fail in a
provides sequential steps to learning python. test script, this provides sequential steps to learning python.
For those used to languages and figuring out puzzles on their own, this can be a fun, attractive option. For those used to languages and figuring out puzzles on their own, this can be
For those new to python and programming, having an additional resource or reference will be helpful. a fun, attractive option. For those new to python and programming, having an
additional resource or reference will be helpful.
`Python Koans <http://bitbucket.org/gregmalcolm/python_koans>`_ `Python Koans <http://bitbucket.org/gregmalcolm/python_koans>`_
@@ -102,5 +110,6 @@ References
Python in a Nutshell Python in a Nutshell
~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~
Python in a Nutshell, written by Alex Martelli, covers most cross-platform python's usage, Python in a Nutshell, written by Alex Martelli, covers most cross-platform
from its syntax to built-in libraries to advanced topics such as writing C extensions. python's usage, from its syntax to built-in libraries to advanced topics such
as writing C extensions.