diff --git a/docs/intro/community.rst b/docs/intro/community.rst index be1176e..329d867 100644 --- a/docs/intro/community.rst +++ b/docs/intro/community.rst @@ -4,14 +4,17 @@ The Community 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 -------------------------- -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 `_. @@ -19,7 +22,8 @@ The mission of the Python Software Foundation is to promote, protect, and advanc 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 `_): @@ -27,7 +31,8 @@ There are three different types of PEPs (as defined by `PEP1 `_: 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 `_. 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 -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 `_. @@ -70,4 +79,6 @@ A comprehensive list of conferences is maintained `at pycon.org `_. +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 `_. diff --git a/docs/intro/documentation.rst b/docs/intro/documentation.rst index 3359f37..cdc796d 100644 --- a/docs/intro/documentation.rst +++ b/docs/intro/documentation.rst @@ -13,7 +13,8 @@ The official Python Language and Library documentation can be found here: 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 `_ diff --git a/docs/intro/learning.rst b/docs/intro/learning.rst index 9a9bada..c04a28e 100644 --- a/docs/intro/learning.rst +++ b/docs/intro/learning.rst @@ -7,14 +7,18 @@ Beginner 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 `_ 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 `_ +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 `_ 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 `_ @@ -22,7 +26,8 @@ This is an excellent beginner programmer's guide to Python. It covers "hello wor 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 `_ @@ -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 is a good book for those ready to jump in to Python 3. It's a -good read if you are moving from Python 2 to 3 or if you already have some +Dive Into Python 3 is a good book for those ready to jump in to Python 3. It's +a good read if you are moving from Python 2 to 3 or if you already have some experience programming in another language. `Dive Into Python 3 `_ @@ -39,30 +44,33 @@ experience programming in another language. Think Python: How to Think Like a Computer Scientist ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Think Python attempts to give an introduction to basic concepts in computer science through the -use of the python language. The focus was to create a book with plenty of exercises, minimal jargon and -a section in each chapter devoted to the subject of debugging. +Think Python attempts to give an introduction to basic concepts in computer +science through the use of the python language. The focus was to create a book +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 -patterns and best practices. +While exploring the various features available in the python language the +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 -in greater detail by applying those topics to real-world examples. Case studies include assignments in GUI -and Markov Analysis. +The book also includes several case studies which have the reader explore the +topics discussed in the book in greater detail by applying those topics to +real-world examples. Case studies include assignments in GUI and Markov +Analysis. `Think Python `_ -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 -to provide an interactive -tutorial teaching basic python concepts. By fixing assertion statements that fail in a test script, this -provides sequential steps to learning python. +Python Koans is a port of Edgecase's Ruby Koans. It uses a test-driven +approach, q.v. TEST DRIVEN DESIGN SECTION to provide an interactive tutorial +teaching basic python concepts. By fixing assertion statements that fail in a + 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 new to python and programming, having an additional resource or reference will be helpful. +For those used to languages and figuring out puzzles on their own, this can be +a fun, attractive option. For those new to python and programming, having an +additional resource or reference will be helpful. `Python Koans `_ @@ -102,5 +110,6 @@ References Python in a Nutshell ~~~~~~~~~~~~~~~~~~~~ -Python in a Nutshell, written by Alex Martelli, covers most cross-platform python's usage, -from its syntax to built-in libraries to advanced topics such as writing C extensions. +Python in a Nutshell, written by Alex Martelli, covers most cross-platform +python's usage, from its syntax to built-in libraries to advanced topics such +as writing C extensions.