#3918: note that uniform() args can be swapped.
diff --git a/Doc/library/random.rst b/Doc/library/random.rst
index fc32e4a..858888c 100644
--- a/Doc/library/random.rst
+++ b/Doc/library/random.rst
@@ -188,7 +188,9 @@
 
 .. function:: uniform(a, b)
 
-   Return a random floating point number *N* such that ``a <= N < b``.
+   Return a random floating point number *N* such that ``a <= N < b`` for
+   ``a <= b`` and ``b <= N < a`` for ``b < a``.
+
 
 .. function:: triangular(low, high, mode)