Add comments to tests.yml

.github/workflows/tests.yml

@@ -28,6 +28,7 @@ jobs:
           COVERALLS_PARALLEL: true
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
+  # do some tests with LC_ALL=C to check for locale variance
   c-locale-test:
     runs-on: ubuntu-16.04
     steps:
@@ -52,6 +53,7 @@ jobs:
           COVERALLS_PARALLEL: true
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
+  # test setup.py using each tested version
   test-setup:
     runs-on: ubuntu-16.04
     strategy:
@@ -79,9 +81,10 @@ jobs:
       - name: Run tox
         run: tox -e ${{ matrix.env }}
 
+  # add a pep8 test
   pep8:
     runs-on: ubuntu-16.04
-    continue-on-error: true
+    continue-on-error: true # pep8 failures shouldn't be considered fatal
     steps:
       - uses: actions/checkout@v2
       - uses: actions/setup-python@v2
@@ -92,6 +95,7 @@ jobs:
       - name: Run tox
         run: tox -e pep8
 
+  # report coverage to coveralls, but only for pytest runs
   finish-coveralls:
     needs: [ unit-tests, c-locale-test ]
     runs-on: ubuntu-16.04