Merge pull request #141 from mahmoudhossam/master

More content.

docs/intro/learning.rst

@@ -76,7 +76,16 @@ additional resource or reference will be helpful.
 
 More information about test driven development can be found at these resources:
 
-    `Test Driven Development <http://en.wikipedia.org/wiki/Test-driven_development>`
+    `Test Driven Development <http://en.wikipedia.org/wiki/Test-driven_development>`_
+
+A Byte of Python
+~~~~~~~~~~~~~~~~
+
+A free introductory book that teaches python at the beginner level, it assumes no
+previous programming experience.
+
+    `A Byte of Python for Python 2.x <http://www.ibiblio.org/swaroopch/byteofpython/read/>`_
+    `A Byte of Python for Python 3.x <http://www.swaroopch.org/notes/Python_en:Table_of_Contents>`_
 
 
 Advanced
@@ -85,7 +94,9 @@ Advanced
 Pro Python
 ~~~~~~~~~~
 
-.. todo:: Write about `Pro Python <http://propython.com/>`_
+This book is for intermediate to advanced Python programmers who are looking to understand how
+and why Python works the way it does and how they can take their code to the next level.
+
 
 Expert Python Programming
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -103,6 +114,14 @@ development, version control, and optimization/profiling.
 
     `Expert Python Programming <http://www.packtpub.com/expert-python-programming/book>`_
 
+The Python Tutorial
+~~~~~~~~~~~~~~~~~~~~
+
+This is the official tutorial, it covers all the basics, and offers a tour of the
+language and the standard library, recommended for those who need a quickstart
+guide to the language.
+
+    `The Python Tutorial <http://docs.python.org/tutorial/index.html>`_
 
 References
 ----------
@@ -113,3 +132,11 @@ 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.
+
+The Python Language Reference
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This is Python's reference manual, it covers the syntax and the core symantics of the
+language.
+
+    `The Python Language Reference <http://docs.python.org/reference/index.html>`_

docs/scenarios/db.rst

@@ -9,7 +9,9 @@ database access modules. It's documented in `PEP 249 <http://www.python.org/dev/
 Nearly all Python database modules such as `sqlite3`, `psycopg` and
 `mysql-python` conform to this interface.
 
-
+Tutorials that explain how to work with modules that conform to this interface can be found
+`here <http://halfcooked.com/presentations/osdc2006/python_databases.html>`_ and
+`here <http://www.amk.ca/python/writing/DB-API.html>`_.
 
 SQLAlchemy
 ----------

docs/starting/which-python.rst

@@ -70,7 +70,7 @@ If you are looking to squeeze more performance out of your Python code, it's
 worth giving PyPy a try. On a suite of benchmarks, it's current `over 5 times
 faster than CPython <http://speed.pypy.org/>`_.
 
-Currently PyPy supports Python 2.7.
+Currently PyPy supports Python 2.7. [#pypy_ver]_
 
 Jython
 ------
@@ -83,7 +83,7 @@ module.
 If you need to interface with an existing Java codebase or have other reasons to
 need to write Python code for the JVM, Jython is the best choice.
 
-Currently Jython supports up to Python 2.5.
+Currently Jython supports up to Python 2.5. [#jython_ver]_
 
 IronPython
 ----------
@@ -96,4 +96,10 @@ expose Python code to other .NET languages.
 IronPython directly in to the Visual Studio development environment, making it
 an ideal choice for Windows developers.
 
-IronPython supports Python 2.7.
+IronPython supports Python 2.7. [#iron_ver]_
+
+.. [#pypy_ver] http://pypy.org/compat.html
+
+.. [#jython_ver] http://wiki.python.org/jython/JythonFaq/GeneralInfo#Is_Jython_the_same_language_as_Python.3F
+
+.. [#iron_ver] http://ironpython.codeplex.com/releases/view/54498