Modernize Markdown workflows and update documentation

- Updated `markdown-check.yaml` and `markdown-fix.yaml` for consistency with
  other repository workflows (e.g., `cmake-format-check`).
- Added robust `workflow_call` support with standard inputs.
- Implemented trigger type emulation in `markdown-check.yaml` to intelligently
  handle relevance checks for automatic vs. manual callers.
- Standardized job naming, checkout paths, and dynamic bot command logic.
- Updated `REUSABLE_WORKFLOWS.md` with comprehensive documentation for
  markdown check/fix workflows and fixed pre-existing linting issues.

Co-authored-by: greenc-FNAL <2372949+greenc-FNAL@users.noreply.github.com>

Author: google-labs-jules[bot]

.github/REUSABLE_WORKFLOWS.md

@@ -12,18 +12,18 @@ Additionally, you can configure your own fork of Phlex to run CI checks on local
 
 If you are a Phlex-affiliated developer working on a dependent package of Phlex, or on a different Cetmodules-using package, or on Cetmodules itself, you may be able to invoke these workflows on your own project following the information in this guide. However, this is only supported for Phlex-affiliated developers, and even then on a best effort basis. We do **not** support or encourage others to utilize these workflows at this time.
 
-#### Running Workflows Manually (`workflow_dispatch`)
+### Running Workflows Manually (`workflow_dispatch`)
 
 Most workflows in this repository can be run manually on any branch, tag, or commit. This is useful for testing changes without creating a pull request or for applying fixes to a specific branch.
 
 To run a workflow manually:
 
-1.  Navigate to the **Actions** tab of the Phlex repository (or your fork).
-1.  In the left sidebar, click the workflow you want to run (e.g., **Clang-Format Check**).
-1.  Above the list of workflow runs, you will see a banner that says "This workflow has a `workflow_dispatch` event trigger." Click the **Run workflow** dropdown on the right.
-1.  Use the **Branch/tag** dropdown to select the branch you want to run the workflow on.
-1.  Some workflows have additional inputs (e.g., the `cmake-build` workflow allows you to specify build combinations). Fill these out as needed.
-1.  Click the **Run workflow** button.
+1. Navigate to the **Actions** tab of the Phlex repository (or your fork).
+1. In the left sidebar, click the workflow you want to run (e.g., **Clang-Format Check**).
+1. Above the list of workflow runs, you will see a banner that says "This workflow has a `workflow_dispatch` event trigger." Click the **Run workflow** dropdown on the right.
+1. Use the **Branch/tag** dropdown to select the branch you want to run the workflow on.
+1. Some workflows have additional inputs (e.g., the `cmake-build` workflow allows you to specify build combinations). Fill these out as needed.
+1. Click the **Run workflow** button.
 
 ### For Contributors Working on a Fork of Phlex
 
@@ -185,6 +185,27 @@ Automatically formats Markdown files using `markdownlint` and commits the change
 - `ref` (string, **required**): The branch or ref to check out.
 - `repo` (string, **required**): The repository to check out from.
 
+### 6. `markdown-check.yaml`
+
+Checks Markdown files for formatting issues using `markdownlint`.
+
+#### Usage Example
+
+```yaml
+jobs:
+  check_markdown:
+    uses: Framework-R-D/phlex/.github/workflows/markdown-check.yaml@cef968c52aab432b836bb28119a9661c82c8b0d1
+```
+
+#### All Inputs
+
+- `checkout-path` (string, optional): Path to check out code to.
+- `skip-relevance-check` (boolean, optional, default: `false`): Bypass the check that only runs if Markdown files have changed. Note that this workflow automatically emulates the trigger type of the caller; it will run relevance checks if called from a `pull_request` or `push` event, and skip them (running on all files) otherwise.
+- `pr-base-sha` (string, optional): Base SHA of the PR for relevance check.
+- `pr-head-sha` (string, optional): Head SHA of the PR for relevance check.
+- `ref` (string, optional): The branch, ref, or SHA to checkout.
+- `repo` (string, optional): The repository to checkout from.
+
 ### Other Workflows
 
-The repository also provides `actionlint-check.yaml`, `cmake-format-check.yaml`, `markdown-check.yaml`, and `codeql-analysis.yaml`, which can be used in a similar manner.
+The repository also provides `actionlint-check.yaml`, `cmake-format-check.yaml`, and `codeql-analysis.yaml`, which can be used in a similar manner.

.github/workflows/markdown-check.yaml

@@ -33,6 +33,10 @@ on:
         description: "Head SHA of the PR for relevance check"
         required: false
         type: string
+      ref:
+        description: "The branch, ref, or SHA to checkout"
+        required: false
+        type: string
       repo:
         description: "The repository to checkout from"
         required: false
@@ -54,9 +58,16 @@ jobs:
   detect-changes:
     needs: pre-check
     if: >
-      github.event_name != 'workflow_dispatch' &&
-      (github.event_name != 'workflow_call' || inputs.skip-relevance-check != 'true') &&
-      needs.pre-check.outputs.is_act != 'true'
+      needs.pre-check.outputs.is_act != 'true' &&
+      (
+        github.event_name == 'pull_request' ||
+        github.event_name == 'push' ||
+        (
+          github.event_name == 'workflow_call' &&
+          inputs.skip-relevance-check != 'true' &&
+          (github.event.pull_request || github.event.before)
+        )
+      )
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -106,7 +117,7 @@ jobs:
     - name: Checkout code
       uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
       with:
-        ref: ${{ (github.event_name == 'workflow_call' && inputs.pr-head-sha) || (github.event_name == 'workflow_dispatch' && github.event.inputs.ref) || github.ref }}
+        ref: ${{ (github.event_name == 'workflow_call' && (inputs.ref || inputs.pr-head-sha)) || (github.event_name == 'workflow_dispatch' && github.event.inputs.ref) || github.ref }}
         path: ${{ env.local_checkout_path }}
         repository: ${{ (github.event_name == 'workflow_call' && inputs.repo) || github.repository }}
 
@@ -136,9 +147,16 @@ jobs:
   markdown-check-skipped:
     needs: [pre-check, detect-changes]
     if: >
-      github.event_name != 'workflow_dispatch' &&
-      (github.event_name != 'workflow_call' || inputs.skip-relevance-check != 'true') &&
       needs.pre-check.outputs.is_act != 'true' &&
+      (
+        github.event_name == 'pull_request' ||
+        github.event_name == 'push' ||
+        (
+          github.event_name == 'workflow_call' &&
+          inputs.skip-relevance-check != 'true' &&
+          (github.event.pull_request || github.event.before)
+        )
+      ) &&
       (needs.detect-changes.result == 'success' && needs.detect-changes.outputs.matched != 'true')
     runs-on: ubuntu-latest
     permissions: