More documentation stubs.

docs/source/deployment.rst

@@ -1,7 +1,7 @@
 .. _deployment:
 
-Deployment Recipes
-==================
+Deploying Pecan in Production
+=============================
 
 Deploying a pecan project can be accomplished in several ways. You may
 already be familiar with deployment methodologies for other Python
@@ -11,70 +11,22 @@ standards laid out by similar Python web frameworks before it.
 Here we will outline some of the common methods for deploying your Pecan
 project.
 
-Good ol' fashioned source control.
------------------------------------
+mod_wsgi
+--------
+TODO
 
-Why not? It works! In our modern world of distributed SCM tools, we find
-using source control as a completely acceptable method for deployment.
-Sure it's a bit more manual than you might like, but it gets the job
-done, and rollbacks are free (if you're into that kind of thing ;)). For
-this guide, it is assumed you are developing your application in a git
-repository.
+FastCGI
+-------
+TODO
 
-Here are some tips, free of charge::
+uWSGI
+-----
+TODO
 
-  * Develop on "feature" branches.
-  * All merge back to "master" when sprint is complete.
-  * Tag "release" branches.
+Tornado
+-------
+TODO
 
-To setup::
-
-  * git clone <project> /opt/project/
-  * git branch --track <release_branch> origin/<release_branch>
-  * git checkout <release_branch>
-  * python setup.py install
-
-To deploy going forward::
-
-  * cd /opt/project/
-  * git pull
-  * git branch --track <release_branch> origin/<release_branch>
-  * git checkout <release_branch>
-  * python setup.py install
-
-That should do it.
-
-Fabric
-------
-
-Fabric makes it way more fun to deploy. You can write straight up python
-to automate the SCM deployments, or even go so far as to build a full fledged
-release system with it.
-
-Capistrono
-----------
-
-Much like fabric, but they built in some out of the box deployment
-tools. We'll cover that here.
-
-Chef
-----
-
-Chef borrows it's deployment methodologies from Capistrono, we'll cover
-that here.
-
-Whiskey Disk
-------------
-
-The embarrassingly fast deployment tool. Decoupled from frameworks, one
-specific design goal, to deploy quickly and easily. YAML configuration.
-
-Egg
----
-
-Deploy binary packages using python's distribution utilities.
-
-RPM
----
-
-Deploy your apps with RPM's, built with python's distribution utilities.
+Gunicorn
+--------
+TODO

docs/source/forms.rst

@@ -2,4 +2,25 @@
 
 Generating and Validating Forms
 ===============================
+Out of the box, Pecan provides no opinionated support for working with
+form generation and validation libraries, but it’s easy to hook into your
+library of choice with minimal effort.
+
+This article details best practices for integrating the popular forms library,
+WTForms, into your Pecan project.
+
+Defining a Form Definition
+--------------------------
+TODO
+
+Rendering a Form in a Template
+------------------------------
+TODO
+
+Validating POST Values
+----------------------
+TODO
+
+Further Documentation
+---------------------
 TODO