diff --git a/docs/writing/tests.rst b/docs/writing/tests.rst
index f014bfdfd..84e5d27db 100644
--- a/docs/writing/tests.rst
+++ b/docs/writing/tests.rst
@@ -116,7 +116,7 @@ A simple doctest in a function:
 .. code-block:: python
 
     def square(x):
-        """Squares x.
+        """Return the square of x.
 
         >>> square(2)
         4