Merge pull request realpython#46 from six8/todo

Mostly added todos, AUTHORS.rst, fixed some links, added some text editors

AUTHORS.rst

@@ -0,0 +1,16 @@
+Authors
+-------
+
+* `Kenneth Reitz <http://kennethreitz.com/>`_ (follow on `Twitter <http://twitter.com/#!/kennethreitz>`_ & `GitHub <https://github.com/kennethreitz>`_)
+* `Aaron Weinberger <http://clipper.ship.edu/~aw9994/>`_ (follow on `GitHub <https://github.com/aaronw>`_)
+* `Kamil Kisiel <http://www.kamilkisiel.net/>`_ (follow on `Twitter <https://twitter.com/#!/kisielk>`_ & `GitHub <https://github.com/kisielk>`_)
+* `Seyi Ogunyemi <http://www.micrypt.com/>`_ (follow on `Twitter <https://twitter.com/#!/micrypt>`_ & `GitHub <https://github.com/micrypt>`_)
+* `Alex Gaynor <http://alexgaynor.net>`_ (follow on `Twitter <http://twitter.com/#!/alex_gaynor>`_ & `Github <https://github.com/alex>`_)
+* `nstielau <http://dev.nuclearrooster.com/>`_ (follow on `GitHub <https://github.com/nstielau>`_)
+* `Adam Brenecki <http://adam.brenecki.id.au/>`_ (follow on `Twitter <https://twitter.com/#!/adambrenecki>`_ & `GitHub <https://github.com/adambrenecki>`_)
+* `Nanda Kishore <http://google.com/profiles/madhav>`_ (follow on `GitHub <https://github.com/madhav>`_)
+* `Donald Stufft <http://dstufft.com/>`_ (follow on `Twitter <https://twitter.com/#!/dstufft>`_ and `GitHub <https://github.com/dstufft>`_)
+* `Brent O'Connor <http://www.epicserve.com/>`_ (follow on `Twitter <http://twitter.com/#!/epicserve>`_ & `GitHub <https://github.com/epicserve>`_)
+* `Dalton Barreto <http://daltonmatos.com/>`_ (follow on `Twitter <https://twitter.com/#!/daltonmatos>`_ & `GitHub <https://github.com/daltonmatos>`_)
+* `Daniel Schauenberg <http://unwiredcouch.com/>`_ (follow on `Twitter <http://twitter.com/#!/mrtazz>`_ & `GitHub <https://github.com/mrtazz>`_)
+* `Mike Thornton <http://devdetails.com/>`_ (follow on `GitHub <https://github.com/six8>`_)

docs/intro/duction.rst

@@ -1,8 +1,7 @@
 Introduction
 ============
 
-Someone should write a general blurb introducing the Python language here.
-
+.. todo:: write a general blurb introducing the Python language
 
 About This Guide
 ----------------

docs/intro/learning.rst

@@ -59,13 +59,9 @@ Advanced
 Pro Python
 ~~~~~~~~~~
 
-TODO: Write about this book
-
-    `Pro Python <http://propython.com/>`_
+.. todo:: Write about `Pro Python <http://propython.com/>`_
 
 Expert Python Programming
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-TODO: Write about this book
-
-    `Expert Python Programming <http://www.packtpub.com/expert-python-programming/book>`_
+.. todo:: Write about `Expert Python Programming <http://www.packtpub.com/expert-python-programming/book>`_

docs/notes/contribute.rst

@@ -16,6 +16,7 @@ If you'd like to contribute, there's plenty to do. Here's a short todo_ list.
 
 
 .. _GitHub: http://github.com/kennethreitz/python-guide/
-.. _AUTHORS: http://github.com/kennethreitz/python-guide/blob/master/AUTHORS
+.. _AUTHORS: http://github.com/kennethreitz/python-guide/blob/master/AUTHORS.rst
 .. _todo: https://github.com/kennethreitz/python-guide/blob/master/TODO.rst
 
+.. include:: ../../AUTHORS.rst

docs/notes/license.rst

@@ -1,4 +1,4 @@
 License
 -------
 
-TBD.
+.. todo:: Determine License

docs/scenarios/admin.rst

@@ -4,14 +4,24 @@ Systems Administration
 Fabric
 ------
 
+.. todo:: Write about Fabric
 
 Chef
 ----
 
+.. todo:: Write about Chef
 
 Puppet
 ------
 
+.. todo:: Write about Puppet
 
 Blueprint
----------
+---------
+
+.. todo:: Write about Blueprint
+
+Buildout
+--------
+
+.. todo:: Write about Buildout

docs/scenarios/ci.rst

@@ -5,23 +5,28 @@ Continuous Integration
 Why?
 ----
 
-Martin Fowler, who first wrote about Continuous Integration (short: CI) together with Kent Beck, describes the CI as follows:
+Martin Fowler, who first wrote about `Continuous Integration <http://martinfowler.com/articles/continuousIntegration.html>`_ (short: CI) together with Kent Beck, describes the CI as follows:
 
     Continuous Integration is a software development practice where members of a team integrate their work frequently, usually each person integrates at least daily - leading to multiple integrations per day. Each integration is verified by an automated build (including test) to detect integration errors as quickly as possible. Many teams find that this approach leads to significantly reduced integration problems and allows a team to develop cohesive software more rapidly. This article is a quick overview of Continuous Integration summarizing the technique and its current usage.
 
-Source: http://martinfowler.com/articles/continuousIntegration.html
-
 Jenkins
 -------
 
-Jenkins CI (http://jenkins-ci.org) is an extensible continuous integration engine. Use it.
+`Jenkins CI <http://jenkins-ci.org>`_ is an extensible continuous integration engine. Use it.
 
 
 
 Buildbot
 --------
-Buildbot (http://buildbot.net/buildbot/docs/current) is a Python system to automate the compile/test cycle to validate code changes. 
+`Buildbot <http://buildbot.net/buildbot/docs/current>`_ is a Python system to automate the compile/test cycle to validate code changes. 
 
 
 Mule?
 -----
+
+.. todo:: Write about Mule
+
+Tox
+---
+
+.. todo:: Write about `Tox <http://codespeak.net/~hpk/tox/>`_

docs/scenarios/cli.rst

@@ -1,8 +1,9 @@
 Command Line Applications
 =========================
 
-
+.. todo:: Explain "Command Line Applications"
 
 Clint
 -----
 
+.. todo:: Write about Clint

docs/scenarios/db.rst

@@ -22,3 +22,7 @@ database-agnostic code without SQL.
 
     pip install sqlalchemy
 
+Django ORM
+----------
+
+.. todo:: Explain Django ORM

docs/scenarios/gui.rst

@@ -12,16 +12,17 @@ http://developer.qt.nokia.com/wiki/PySideDownloads/
 
 PyQt
 ----
-*Note: If your software does not fully comply with the GPL you will need a commercial license!*
+.. note:: If your software does not fully comply with the GPL you will need a commercial license!
+
 http://www.riverbankcomputing.co.uk/software/pyqt/download
 
 Cocoa
 :::::
-*Note: The Cocoa framework is only available on Mac OSX. Don't pick this if you're writing a cross-platform application!*
+.. note:: The Cocoa framework is only available on Mac OSX. Don't pick this if you're writing a cross-platform application!
 
 PyObjC
 ------
-*Note: Only available on Mac OSX. Don't pick this if you're writing a cross-platform application.*
+.. note:: Only available on Mac OSX. Don't pick this if you're writing a cross-platform application.
 
 WXPython
 ::::::::

docs/scenarios/speed.rst

@@ -3,6 +3,7 @@ Speed
 
 CPython, the most commonly used implementation of Python, is slow for CPU bound tasks. `PyPy`_ is fast.
 
+.. todo:: Fill in stub for Speed comparisons
 
 Context
 :::::::

docs/scenarios/web.rst

@@ -74,10 +74,13 @@ already exist to suit your needs.
 Pyramid
 -------
 
+.. todo:: Explian Pyramid
 
 Servers
 :::::::
 
+.. todo:: Explain Apache deployment
+
 Apache + mod_wsgi
 -----------------
 
@@ -107,6 +110,7 @@ setup for Nginx + gUnicorn can be found in the gUnicorn
 Mongrel2 + Brubeck
 ------------------
 
+.. todo:: Explain Mongrel2 + Brubeck
 
 Mongrel2 + wsgid
 ----------------
@@ -209,6 +213,8 @@ Gondor publishes guides to deploying `Django projects
 Shared Web Hosting
 ------------------
 
+.. todo:: Fill in "Shared Web Hosting" stub
+
 WebFaction
 ~~~~~~~~~~~
 

docs/shipping/freezing.rst

@@ -10,6 +10,9 @@ Many applications you use every day do this:
 - BitTorrent
 -
 
+
+.. todo:: Fill in "Freezing Your Code" stub
+
 Windows
 :::::::
 

docs/shipping/packaging.rst

@@ -3,6 +3,7 @@ Packaging Your Code
 
 Packaging your code is important.
 
+.. todo:: Write introduction for "Packaging Your Code"
 
 For Python Developers
 :::::::::::::::::::::
@@ -14,7 +15,7 @@ If you're writing an open source Python module, `PyPI <http://pypi.python.org>`_
 Pip vs. easy_install
 --------------------
 
-Use pip.  More details `here <http://stackoverflow.com/questions/3220404/why-use-pip-over-easy-install>`_
+Use `pip <http://pypi.python.org/pypi/pip>`_.  More details `here <http://stackoverflow.com/questions/3220404/why-use-pip-over-easy-install>`_
 
 
 Personal PyPI
@@ -54,10 +55,13 @@ $ pip install  http://127.0.0.1:9000/MyPackage.tar.gz
 Chishop
 +++++++
 
+`Chishop <https://github.com/benliles/djangopypi>`_ is a simple PyPI server written in django which allows you to register/upload with distutils and install with easy_install/pip.
 
 For Linux Distributions
 ::::::::::::::::::::::::
 
+.. todo:: Fill in "For Linux Distributions" packaging stub
+
 Useful Tools
 ------------
 

docs/starting/dev-env.rst

@@ -54,14 +54,27 @@ the following lines into your vimrc::
 
 .. todo:: add supertab notes
 
+TextMate
+--------
+
+"`TextMate <http://macromates.com/>`_ brings Apple's approach to operating systems into the world of text editors. By bridging UNIX underpinnings and GUI, TextMate cherry-picks the best of both worlds to the benefit of expert scripters and novice users alike."
+
+Sublime Text
+------------
+
+"`Sublime Text <http://www.sublimetext.com/>`_ is a sophisticated text editor for code, html and prose. You'll love the slick user interface and extraordinary features."
+
+Sublime Text uses Python for its plugin API.
+
+`Sublime Text 2 <http://www.sublimetext.com/blog/articles/sublime-text-2-beta>`_ is currently in beta.
 
 IDEs
 ::::
 
 PyCharm / IntelliJ IDEA
 -----------------------
 
-PyCharm is developed by JetBrains, also known for IntelliJ IDEA. Both share the same code base and most of PyCharm's features can be brought to IntelliJ with the free `Python Plug-In <http://plugins.intellij.net/plugin/?id=631/>`_..
+`PyCharm <http://www.jetbrains.com/pycharm/>`_ is developed by JetBrains, also known for IntelliJ IDEA. Both share the same code base and most of PyCharm's features can be brought to IntelliJ with the free `Python Plug-In <http://plugins.intellij.net/plugin/?id=631/>`_.
 
 Eclipse
 -------
@@ -82,8 +95,7 @@ Spyder
 Includes integration with pyflakes_, `pylint <http://www.logilab.org/857>`_,
 and `rope <http://rope.sourceforge.net/>`_.
 
-Spyder is open-source (free), offers code completion, syntax highlighting, class and function browser, and object
-inspection
+Spyder is open-source (free), offers code completion, syntax highlighting, class and function browser, and object inspection.
 
 
 
@@ -185,7 +197,7 @@ control by adding it to the ignore list.
 virtualenvwrapper
 -----------------
 
-Virtualenvwrapper makes virtualenv a pleasure to use by wrapping the command line API with a nicer CLI.
+`Virtualenvwrapper <http://pypi.python.org/pypi/virtualenvwrapper>`_ makes virtualenv a pleasure to use by wrapping the command line API with a nicer CLI.
 
 ::
 
@@ -206,9 +218,17 @@ Other Tools
 IPython
 -------
 
+`IPython <http://ipython.org/>`_ provides a rich toolkit to help you make the most out of using Python interactively. Its main components are:
+
+* Powerful Python shells (terminal- and Qt-based).
+* A web-based notebook with the same core features but support for rich media, text, code, mathematical expressions and inline plots.
+* Support for interactive data visualization and use of GUI toolkits.
+* Flexible, embeddable interpreters to load into your own projects.
+* Tools for high level and interactive parallel computing.
+
 ::
 
-    $ pip install ipython
+    pip install ipython
 
 
 
@@ -217,6 +237,6 @@ BPython
 
 ::
 
-    $ pip install bpython
+    pip install bpython
 
 

docs/writing/license.rst

@@ -4,7 +4,7 @@ Choosing a License
 Open source.
 
 
-
+.. todo:: Fill in License stub
 
 
 Non-Restrictive

docs/writing/structure.rst

@@ -3,6 +3,7 @@ Structuring Your Project
 
 Structuring your project properly is extremely important.
 
+.. todo:: Fill in "Structuring Your Project" stub
 
 Structure is Key
 ----------------