mirror of
https://github.com/kennethreitz/python-guide.git
synced 2026-06-05 23:00:18 +00:00
pep it up
This commit is contained in:
@@ -25,16 +25,27 @@ There are three different types of PEPs (as defined by `PEP1 <http://www.python.
|
|||||||
Describes a process related to Python.
|
Describes a process related to Python.
|
||||||
|
|
||||||
|
|
||||||
|
Notable PEPs
|
||||||
|
~~~~~~~~~~~~
|
||||||
|
|
||||||
There are a few PEPs that could be considered required reading:
|
There are a few PEPs that could be considered required reading:
|
||||||
|
|
||||||
- `PEP8 <http://www.python.org/dev/peps/pep-0008/>`_: The Python Style Guide. Read this. All of it. Follow it.
|
- `PEP8 <http://www.python.org/dev/peps/pep-0008/>`_: The Python Style Guide.
|
||||||
|
Read this. All of it. Follow it.
|
||||||
|
|
||||||
- `PEP20 <http://www.python.org/dev/peps/pep-0020/>`_: The Zen of Python. A list of 19 statements that briefly explain the philosophy behind Python.
|
- `PEP20 <http://www.python.org/dev/peps/pep-0020/>`_: The Zen of Python.
|
||||||
|
A list of 19 statements that briefly explain the philosophy behind Python.
|
||||||
|
|
||||||
- `PEP257 <http://www.python.org/dev/peps/pep-0257/>`_: Docstring Conventions. Gives guidelines for semantics and conventions associated with Python docstrings.
|
- `PEP257 <http://www.python.org/dev/peps/pep-0257/>`_: Docstring Conventions.
|
||||||
|
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
|
||||||
|
~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
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:
|
||||||
|
|
||||||
.. image:: http://www.python.org/dev/peps/pep-0001/pep-0001-1.png
|
.. image:: http://www.python.org/dev/peps/pep-0001/pep-0001-1.png
|
||||||
Reference in New Issue
Block a user