add documentation to workflows

Signed-off-by: Mic Bowman <[email protected]>

Author: cmickeyb

Diff for: .github/workflows/configured_test.yml

@@ -2,6 +2,10 @@
 # SPDX-License-Identifier: Apache-2.0
 #
 
+# This workflow is intended to provide an interactive way of configuring
+# PDO tests. Common configuration variables can be set interactively to
+# debug differences between local and github.
+
 name: Run specific PDO tests
 on:
   workflow_dispatch:
@@ -32,6 +36,7 @@ on:
           - SMALL
           - MEDIUM
           - LARGE
+
 jobs:
     pdo_specific_tests:
         name: Run specific PDO tests

Diff for: .github/workflows/full_test.yml

@@ -2,6 +2,12 @@
 # SPDX-License-Identifier: Apache-2.0
 #
 
+# This workflow is intended to be used as a validity test for any
+# pull request. That is, this is a minimal functionality that must
+# be successfully executed prior to merging a pull request. Note
+# that this can be overridden by adding '[skip ci]' in the commit
+# name. This should not be done on the main PDO branch.
+
 name: Run full PDO tests
 on: [ pull_request ]