diff --git a/docs/intro/community.rst b/docs/intro/community.rst index da16cfc..422b098 100644 --- a/docs/intro/community.rst +++ b/docs/intro/community.rst @@ -6,3 +6,34 @@ BDFL Python Software Foundation -------------------------- + + +PEPs +---- + +PEPs are *Python Enhancement Proposals*. They are define change to Python itself, or the standards around it. + +There are three different types of PEPs (as defined by `PEP1 `_): + + **Standards** + Describes a new feature or implementation. + + **Informational** + Describes a design issue, general guidelines, or information to the community. + + **Process** + Describes a process related to Python. + + +There are a few PEPs that could be considered required reading: + +- `PEP8 `_: The Python Style Guide. + +- `PEP20 `_: The Zen of Python. A list of 19 statements that briefly explain the philosophy behind Python. + +- `PEP257 `_: Docstring Conventions. Gives guidelines for semantics and conventions associated with Python docstrings. + + + PEPs are peer-reviewed and accepted/rejected after much discussion. Anyone can write and submit a PEP for review. + + .. image:: http://www.python.org/dev/peps/pep-0001/pep-0001-1.png \ No newline at end of file