Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Refactored the Introduction section.

Removed redundant links to learning resources and separated the
learning, documentation, and news sections in to their own pages.
  • Loading branch information...
commit 1557d0ca739d8d687de20a3e060a7b79d42dc6c2 1 parent 1cb4fa8
Kamil Kisiel kisielk authored
6 docs/contents.rst.inc
View
@@ -9,7 +9,9 @@ background information about Python, then focuses on next steps.
intro/duction
intro/community
- intro/resources
+ intro/learning
+ intro/documentation
+ intro/news
Getting Started
@@ -81,4 +83,4 @@ Contibution notes and legal information are here (for those interested).
:maxdepth: 2
notes/contribute
- notes/license
+ notes/license
20 docs/intro/documentation.rst
View
@@ -0,0 +1,20 @@
+Documentation
+=============
+
+Official Documentation
+----------------------
+
+The official Python Language and Library documentation can be found here:
+
+ - `Python 2.x <http://docs.python.org/>`_
+ - `Python 3.x <http://docs.python.org/py3k/>`_
+
+
+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 <http://readthedocs.org/>`_
+
+
25 docs/intro/duction.rst
View
@@ -1,27 +1,4 @@
Introduction
============
-
-Learning Python
-:::::::::::::::
-
-Beginners
-`````````
-
-* `learnpython.org <http://www.learnpython.org/>`_ - 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.
-
-* `Dive Into Python 3 <http://diveintopython3.ep.io/>`_ - Dive into Python 3 is a no non-sense approach to Python and is suited for someone that already knows how to program but now wants to learn Python.
-
-
-Learn Python the Hard Way
--------------------------
-
-
-Advanced
-````````
-
-Pro Python
-----------
-
-Expert Python Programming
--------------------------
+Someone should write a general blurb introducing the Python language here
55 docs/intro/learning.rst
View
@@ -0,0 +1,55 @@
+Learning Python
+===============
+
+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.
+
+ `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.
+
+ `Learn Python the Hard Way <http://learnpythonthehardway.org/book/>`_
+
+
+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.
+
+ `Crash into Python <http://stephensugden.com/crash_into_python/>`_
+
+
+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
+experience programming in another language.
+
+ `Dive Into Python 3 <http://diveintopython3.ep.io/>`_
+
+
+Advanced
+--------
+
+Pro Python
+~~~~~~~~~~
+
+TODO: Write about this book
+
+ `Pro Python <http://propython.com/>`_
+
+Expert Python Programming
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+TODO: Write about this book
+
+ `Expert Python Programming <http://www.packtpub.com/expert-python-programming/book>`_
17 docs/intro/news.rst
View
@@ -0,0 +1,17 @@
+News
+====
+
+Planet Python
+~~~~~~~~~~~~~
+
+This is an aggregate of Python news from a growing number of developers.
+
+ `Planet Python <http://planet.python.org>`_
+
+/r/python
+~~~~~~~~~
+
+/r/python is the Reddit Python community where users contribute and vote on
+Python-related news.
+
+ `/r/python <http://reddit.com/r/python>`_
70 docs/intro/resources.rst
View
@@ -1,70 +0,0 @@
-Documentation
-=============
-
-Official Documentation
-----------------------
-
-The official Python Language and Library documentation can be found here:
-
- - `Python 2.x <http://docs.python.org/>`_
- - `Python 3.x <http://docs.python.org/py3k/>`_
-
-
-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 <http://readthedocs.org/>`_
-
-
-Resources
-=========
-
-News
-----
-
-Planet Python
-~~~~~~~~~~~~~
-
-This is an aggregate of Python news from a growing number of developers.
-
- `Planet Python <http://planet.python.org>`_
-
-/r/python
-~~~~~~~~~
-
-/r/python is the Reddit Python community where users contribute and vote on
-Python-related news.
-
- `/r/python <http://reddit.com/r/python>`_
-
-
-Beginner's Guides
------------------
-
-
-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.
-
- `Learn Python the Hard Way <http://learnpythonthehardway.org/book/>`_
-
-
-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.
-
- `Crash into Python <http://stephensugden.com/crash_into_python/>`_
-
-
-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
-experience programming in another language.
-
- `Dive Into Python 3 <http://diveintopython3.ep.io/>`_
Please sign in to comment.
Something went wrong with that request. Please try again.