diff --git a/roles/tox/README.rst b/roles/tox/README.rst
index 8ace6a443..2e0c06f82 100644
--- a/roles/tox/README.rst
+++ b/roles/tox/README.rst
@@ -3,6 +3,7 @@ Runs tox for a project
 **Role Variables**
 
 .. zuul:rolevar:: tox_environment
+   :type: dict
 
    Environment variables to pass in to the tox run.
 
diff --git a/zuul.d/python-jobs.yaml b/zuul.d/python-jobs.yaml
index dc7c94819..3192700ad 100644
--- a/zuul.d/python-jobs.yaml
+++ b/zuul.d/python-jobs.yaml
@@ -14,9 +14,9 @@
          Use the specified tox environments (``ALL`` selects all).
 
       .. zuul:jobvar:: tox_environment
+         :type: dict
 
-         List of user defined environmental variables to pass to bash
-         shell.
+         Environment variables to pass in to the tox run.
 
       .. zuul:jobvar:: tox_extra_args
 
@@ -202,9 +202,9 @@
          Use the specified tox environments (``ALL`` selects all).
 
       .. zuul:jobvar:: tox_environment
+         :type: dict
 
-         List of user defined environmental variables to pass to bash
-         shell.
+         Environment variables to pass in to the tox run.
 
       .. zuul:jobvar:: tox_extra_args