table and overview in docker-testing readme ; and sleep comment

Author: d-w-moore

docker-testing/README.md

@@ -1,10 +1,14 @@
 # A Topological Setup for Testing the Python Client
 
 The `docker-testing` directory contains the necessary files for building and
-running tests from the perspective of a specific client node in a larger network.
+running the client test suite from the perspective of a specific client node
+(separate from the iRODS server node it targets for the tests).
+
+The client, provider, and database are currently run on distinct nodes within
+a network topology set up by `docker compose` for the tests.
 
 We currently allow a choice of Python interpreter and iRODS server to be installed
-on the client and provider nodes of a simulated network topology.
+on the client and provider nodes, respectively.
 
 The choice of versions are dictated when running the test:
 

irods/test/scripts/test003_write_pam_credentials_to_secrets_file.bats

@@ -44,6 +44,7 @@ except irods.client_init.irodsA_already_exists:
 
     # Now delete the already existing irodsA and repeat without negating overwrite.
     TIMESTAMP_0=$(stat -c%Y $auth_file)
+    # The sleep ensures the mtime of $auth_file will change if/when it is rewritten.
     sleep 2
     $PYTHON -c "import irods.client_init; irods.client_init.write_pam_irodsA_file('$ALICES_NEW_PAM_PASSWD')"
     TIMESTAMP=$(stat -c%Y $auth_file)