From d02efa81f2b29fc95224ea4efaba6e354485e00e Mon Sep 17 00:00:00 2001
From: Kenneth Reitz <me@kennethreitz.org>
Date: Wed, 17 Oct 2018 05:12:11 -0700
Subject: [PATCH] deployment

---
 docs/source/deployment.rst | 42 ++++++++++++++++++++++++++++++++++++++
 docs/source/index.rst      |  1 +
 2 files changed, 43 insertions(+)
 create mode 100644 docs/source/deployment.rst

diff --git a/docs/source/deployment.rst b/docs/source/deployment.rst
new file mode 100644
index 0000000..7c6c4cc
--- /dev/null
+++ b/docs/source/deployment.rst
@@ -0,0 +1,42 @@
+Deploying Responder
+===================
+
+You can deploy Responder anywhere you can deploy a basic Python application.
+
+Heroku Deployment
+-----------------
+
+The basics::
+
+    $ mkdir myapp
+    $ cd myapp
+    $ git init
+    $ heroku create
+    ...
+
+Install Responder::
+
+    $ pipenv install responder
+    ...
+
+Write out a `api.py`::
+
+    import responder
+
+    api = responder.API()
+
+    @api.route("/")
+    async def hello(req, resp):
+        resp.text = "hello, world!"
+
+    api.run()
+
+Write out a ``Procfile``::
+
+    web: python api.py
+
+That's it! Next, we commit and push to Heroku::
+
+    $ git add -A
+    $ git commit -m 'initial commit'
+    $ git push heroku master
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 727838d..2ebba01 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -104,6 +104,7 @@ User Guides
 
    quickstart
    tour
+   deployment
    api