From 77521c6cd7828433f9e71dabcceb9455b28593c5 Mon Sep 17 00:00:00 2001
From: Simon Willison <swillison@gmail.com>
Date: Fri, 11 Sep 2020 11:40:39 -0700
Subject: [PATCH] Documentation for --pdb, refs #962

---
 docs/contributing.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/contributing.rst b/docs/contributing.rst
index 3b359447..39d4c3a2 100644
--- a/docs/contributing.rst
+++ b/docs/contributing.rst
@@ -86,6 +86,17 @@ Then run Datasette like this::
 
     datasette fixtures.db -m fixtures-metadata.json --plugins-dir=fixtures-plugins/
 
+.. _contributing_debugging:
+
+Debugging
+---------
+
+Any errors that occur while Datasette is running while display a stack trace on the console.
+
+You can tell Datasette to open an interactive ``pdb`` debugger session if an error occurs using the ``--pdb`` option::
+
+    datasette --pdb fixtures.db
+
 .. _contributing_documentation:
 
 Editing and building the documentation