diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt
index 18e8ec1ca0..492ec50b30 100644
--- a/docs/ref/django-admin.txt
+++ b/docs/ref/django-admin.txt
@@ -1300,6 +1300,10 @@ correctly:
 This feature isn't available on Windows. It doesn't work with the Oracle
 database backend either.
 
+If you want to use :mod:`pdb` while debugging tests, you must disable parallel
+execution (``--parallel=1``). You'll see something like ``bdb.BdbQuit`` if you
+don't.
+
 .. warning::
 
     When test parallelization is enabled and a test fails, Django may be