diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
index 4a9c78a3db..f4e5c37d76 100644
--- a/docs/ref/settings.txt
+++ b/docs/ref/settings.txt
@@ -665,8 +665,22 @@ TEST
 Default: ``{}``
 
 A dictionary of settings for test databases; for more details about the
-creation and use of test databases, see :ref:`the-test-database`. The
-following entries are available:
+creation and use of test databases, see :ref:`the-test-database`.
+
+Here's an example with a test database configuration::
+
+    DATABASES = {
+        'default': {
+            'ENGINE': 'django.db.backends.postgresql',
+            'USER': 'mydatabaseuser',
+            'NAME': 'mydatabase',
+            'TEST': {
+                'NAME': 'mytestdatabase',
+            },
+        },
+    }
+
+The following keys in the ``TEST`` dictionary are available:
 
 .. setting:: TEST_CHARSET