diff --git a/Doc/source/designspaceLib/readme.rst b/Doc/source/designspaceLib/readme.rst
index 5af5d636b..06bf46ffc 100644
--- a/Doc/source/designspaceLib/readme.rst
+++ b/Doc/source/designspaceLib/readme.rst
@@ -278,16 +278,17 @@ AxisDescriptor object
 -  ``labelNames``: dict. When defining a non-registered axis, it will be
    necessary to define user-facing readable names for the axis. Keyed by
    xml:lang code. Varlib.
--  ``minimum``: number. The minimum value for this axis. MutatorMath +
-   Varlib.
--  ``maximum``: number. The maximum value for this axis. MutatorMath +
-   Varlib.
--  ``default``: number. The default value for this axis, i.e. when a new
-   location is created, this is the value this axis will get.
+-  ``minimum``: number. The minimum value for this axis in user space.
    MutatorMath + Varlib.
--  ``map``: list of input / output values that can describe a warp of
-   user space to designspace coordinates. If no map values are present,
-   it is assumed it is [(minimum, minimum), (maximum, maximum)]. Varlib.
+-  ``maximum``: number. The maximum value for this axis in user space.
+   MutatorMath + Varlib.
+-  ``default``: number. The default value for this axis, i.e. when a new
+   location is created, this is the value this axis will get in user
+   space. MutatorMath + Varlib.
+-  ``map``: list of input / output values that can describe a warp of user space
+   to design space coordinates. If no map values are present, it is assumed user
+   space is the same as design space, as in [(minimum, minimum), (maximum, maximum)].
+   Varlib.
 
 .. code:: python