lines less than 80 chars in /intro/
authorTomas Thor Jonsson <benregn@gmail.com>
Mon, 23 Apr 2012 17:51:47 +0000 (19:51 +0200)
committerTomas Thor Jonsson <benregn@gmail.com>
Mon, 23 Apr 2012 17:51:47 +0000 (19:51 +0200)
docs/intro/community.rst
docs/intro/documentation.rst
docs/intro/learning.rst

index be1176e..329d867 100644 (file)
@@ -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 <http://www.python.org/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 <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.
 
     **Informational**
-        Describes a design issue, general guidelines, or information to the community.
+        Describes a design issue, general guidelines, or information to the
+        community.
 
     **Process**
         Describes a process related to Python.
@@ -45,24 +50,28 @@ There are a few PEPs that could be considered required reading:
     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.
+    Gives guidelines for semantics and conventions associated with Python
+    docstrings.
 
 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
 
 
-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/>`_.
 
@@ -70,4 +79,6 @@ A comprehensive list of conferences is maintained `at pycon.org <http://www.pyco
 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>`_.
index 3359f37..cdc796d 100644 (file)
@@ -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 <http://readthedocs.org/>`_
 
index 9a9bada..c04a28e 100644 (file)
@@ -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 <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 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/>`_
 
@@ -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 <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 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
+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 <http://diveintopython3.ep.io/>`_
@@ -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 <http://greenteapress.com/thinkpython/html/index.html>`_
 
 
-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 <http://bitbucket.org/gregmalcolm/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.