allura git commit: Add a note to the debug section about how to do it with docker

[br...@apache.org]

Repository: allura
Updated Branches:
  refs/heads/db/debug_docker [created] 8ecbbea83


Add a note to the debug section about how to do it with docker


Project: http://git-wip-us.apache.org/repos/asf/allura/repo
Commit: http://git-wip-us.apache.org/repos/asf/allura/commit/8ecbbea8
Tree: http://git-wip-us.apache.org/repos/asf/allura/tree/8ecbbea8
Diff: http://git-wip-us.apache.org/repos/asf/allura/diff/8ecbbea8

Branch: refs/heads/db/debug_docker
Commit: 8ecbbea8328f9e8559052d96d2364f369d810d8c
Parents: 7160b34
Author: Dave Brondsema <da...@brondsema.net>
Authored: Fri Feb 23 11:31:19 2018 -0500
Committer: Dave Brondsema <da...@brondsema.net>
Committed: Fri Feb 23 11:31:19 2018 -0500

----------------------------------------------------------------------
 Allura/docs/development/contributing.rst | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/allura/blob/8ecbbea8/Allura/docs/development/contributing.rst
----------------------------------------------------------------------
diff --git a/Allura/docs/development/contributing.rst b/Allura/docs/development/contributing.rst
index 40c6aca..0f4ab92 100644
--- a/Allura/docs/development/contributing.rst
+++ b/Allura/docs/development/contributing.rst
@@ -186,11 +186,23 @@ foreground::
     # taskd
     pkill "^taskd"; paster taskd development.ini --nocapture
 
-Make a request to the web app, and when your line of code is hit, a debug
+Then make a request to the web app, and when your line of code is hit, a debug
 session will start on the console where the process is running.
 
 For more information about using ``pdb``, see the `official documentation
-<http://docs.python.org/2/library/pdb.html>`_.
+<http://docs.python.org/2/library/pdb.html>`_.  ``ipdb`` is version of ``pdb`` with
+support for IPython's tab completion, syntax highlighting etc.  Other debugger packages such
+as ``pudb`` are also available.
+
+.. note::
+
+   To do this with docker, the commands are::
+
+       docker-compose run web pip install ipdb
+       docker-compose stop web taskd
+       docker-compose run --service-ports web gunicorn --reload --paste Allura/docker-dev.ini
+       docker-compose run taskd paster taskd docker-dev.ini --nocapture
+
 
 Testing
 -------