Improve wording of docker testing notes

diff --git a/tests/README.rst b/tests/README.rst
index 20e4e2be2af9aefddf3fa7387b327a5ca246c5fb..d7f68c4ff8feb6131cd3366865f44426be84bb88 100644 (file)
--- a/tests/README.rst
+++ b/tests/README.rst
@@ -59,13 +59,15 @@ Test options
 Testing in docker
 -----------------
 
-Useful order to test other Python versions without installing them. Can be
-used to replicate GitHub actions failures, specifying a ``--randomly-seed``.
-The following ``PG*`` env vars are an example to adjust the test dsn::
-
-    docker run -ti --rm --volume `pwd`:/src --workdir /src \
-        -e PSYCOPG3_TEST_DSN -e PGHOST=172.17.0.1 -e PGUSER=`whoami` \
-        python:3.7 bash
-
-    pip install -e ./psycopg3[test] ./psycopg3_c
-    pytest
+Useful to test different Python versions without installing them. Can be used
+to replicate GitHub actions failures, specifying the ``--randomly-seed`` used
+in the test run. The following ``PG*`` env vars are an example to adjust the
+test dsn in order to connect to a database running on the docker host: specify
+a set of env vars working for your setup::
+
+    $ docker run -ti --rm --volume `pwd`:/src --workdir /src \
+      -e PSYCOPG3_TEST_DSN -e PGHOST=172.17.0.1 -e PGUSER=`whoami` \
+      python:3.7 bash
+
+    # pip install -e ./psycopg3[test] ./psycopg3_c
+    # pytest