diff --git a/.circleci/config.yml b/.circleci/config.yml
index 2b1e3c8f..509bbfb4 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -1,7 +1,8 @@
-# Python CircleCI 2.0 configuration file
-#
-# Check https://circleci.com/docs/2.0/language-python/ for more details
-#
+# To run the tests, CircleCI needs these environment variables:
+# QT_EMAIL - email address for a Qt account
+# QT_PASSWORD - password for a Qt account
+# (Unfortunately you can't install Qt without logging in.)
+
 version: 2
 workflows:
   version: 2
@@ -39,7 +40,7 @@ jobs:
             poetry install
 
       - run:
-          name: run flake tests
+          name: Run flake tests
           command: |
             # stop the build if there are Python syntax errors or undefined names
             flake8 . --count --select=E901,E999,F821,F822,F823 --show-source --statistics
@@ -47,7 +48,7 @@ jobs:
             flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
 
       - run:
-          name: run tests
+          name: Run unit tests
           command: |
             xvfb-run -s "-screen 0 1280x1024x24" poetry run pytest --rungui -vvv --no-qt-log tests/