better skeleton

docs/contents.rst.inc

@@ -10,9 +10,13 @@ instructions for web development with Flask.
 
    foreword
    installation
+   which-python
+   dev-env
    useful-tools
    tutorial/index
    project-structure
+   documentation
+   testing
    packaging
    templating
    testing

docs/dev-env.rst

@@ -0,0 +1,53 @@
+Your Development Environment
+============================
+
+Testing your code is very important.
+
+
+Editors
+:::::::
+
+
+Text Editors
+-------------
+
+
+
+IDEs
+----
+
+
+
+Interpreter Tools
+:::::::::::::::::
+
+
+virtualenv
+----------
+
+
+virtualenvwrapper
+-----------------
+
+
+
+Other Tools
+:::::::::::
+
+IPython
+-------
+
+::
+
+    $ pip install ipython
+
+
+
+BPython
+-------
+
+::
+
+    $ pip install bpython
+
+

docs/documentation.rst

@@ -0,0 +1,20 @@
+Documenting Your Code
+=====================
+
+Documenting your code is extremely important. It is debatebly even
+more important than testing.
+
+
+The Basics
+::::::::::
+
+
+Code Comments
+-------------
+
+
+
+Doc Strings
+-----------
+
+

docs/testing.rst

@@ -0,0 +1,31 @@
+Testing Your Code
+=====================
+
+Testing your code is very important.
+
+
+The Basics
+::::::::::
+
+
+Code Comments
+-------------
+
+
+
+Doc Strings
+-----------
+
+
+Tools
+:::::
+
+
+Unittest2
+---------
+
+
+tox
+---
+
+

docs/useful-tools.rst

@@ -1,18 +0,0 @@
-Useful Tools
-============
-
-IPython
--------
-
-::
-
-    $ pip install ipython
-
-
-
-BPython
--------
-
-::
-
-    $ pip install bpython

docs/which-python.rst

@@ -0,0 +1,25 @@
+Picking an Interpreter
+======================
+
+Which Python to use?
+
+
+2.x vs 3.x
+::::::::::
+
+
+
+History
+-------
+
+
+
+Today
+-----
+
+Use 2.7.
+
+
+
+Which Python to Support?
+::::::::::::::::::::::::