Markdown linting

.github/workflows/check-restricted-files.yaml

@@ -33,6 +33,6 @@ jobs:
 
           echo This PR contains changes to files that should not be changed:
           echo
-          git diff --compact-summary origin/${{ github.event.pull_request.base.ref }} origin/${{ github.event.pull_request.head.ref }} -- versions/[0-9].[0-9].[0-9].md
+          git diff --compact-summary origin/${{ github.event.pull_request.base.ref }} -- versions/[0-9].[0-9].[0-9].md
 
           exit 1

.github/workflows/validate-markdown.yaml

@@ -13,20 +13,24 @@ on:
   workflow_dispatch: {}
 
 jobs:
-  mdv:
+  lint:
     runs-on: ubuntu-latest
 
     steps:
       - uses: actions/checkout@v5 # checkout repo content
         with:
           fetch-depth: 0
-      # - name: use the javascript environment from main
-      #   run: |
-      #     git checkout remotes/origin/main -- package.json package-lock.json .markdownlint.yaml
+
       - uses: actions/setup-node@v6 # setup Node.js
         with:
           node-version: "22.x"
-      - name: Validate markdown
-        run: npx --yes mdv versions/*.md
+
       - name: Lint markdown
-        run: npx --yes markdownlint-cli --config .markdownlint.yaml versions/*.md
+        run: npx --yes markdownlint-cli2 --config .markdownlint.yaml npx markdownlint-cli2 *.md schemas/**/*.md versions/*.md
+
+      - name: Check links in markdown files
+        uses: umbrelladocs/action-linkspector@v1
+        with:
+          reporter: github-check
+          fail_level: any
+          filter_mode: file

.linkspector.yml

@@ -0,0 +1,3 @@
+dirs:
+  - ./
+useGitIgnore: true

CONTRIBUTING.md

@@ -34,10 +34,11 @@ Pull requests must come from a fork; create a fresh branch on your fork based on
 
 Overview of branches:
 
-The `main` branch holds 
+The `main` branch holds
+
 - published versions of the specification, named `versions/X.Y.Z.md`,
 - work-in-progress versions of the specification, named `versions/X.Y.Z-dev.md`,
-- sources for published schema versions in  `schemas/vX.Y` folders and their tests in `tests/vX.Y` folders,
+- sources for published schema versions in `schemas/vX.Y` folders and their tests in `tests/vX.Y` folders,
 - sources for work-in-progress schema versions in `schemas/vX.Y-dev` folders and their tests in `tests/vX.Y-dev` folders,
 - utility scripts and supporting documentation.
 

EDITORS.md

@@ -2,14 +2,14 @@
 
 ## Active
 
-* Lorna Mitchell [@lornajane](https://github.com/lornajane)
-* Mike Kistler [@mikekistler](https://github.com/mikekistler)
-* Vincent Biret [@baywet](https://github.com/baywet)
+- Lorna Mitchell [@lornajane](https://github.com/lornajane)
+- Mike Kistler [@mikekistler](https://github.com/mikekistler)
+- Vincent Biret [@baywet](https://github.com/baywet)
 
 ## Emeritus
 
-* Darrel Miller [@darrelmiller](https://github.com/darrelmiller)
-* Greg Dennis [@gregsdennis](https://github.com/gregsdennis)
-* Kevin Swiber [@kevinswiber](https://github.com/kevinswiber)
-* Mike Ralphson [@MikeRalphson](https://github.com/MikeRalphson)
-* Ron Ratovsky [@webron](https://github.com/webron)
+- Darrel Miller [@darrelmiller](https://github.com/darrelmiller)
+- Greg Dennis [@gregsdennis](https://github.com/gregsdennis)
+- Kevin Swiber [@kevinswiber](https://github.com/kevinswiber)
+- Mike Ralphson [@MikeRalphson](https://github.com/MikeRalphson)
+- Ron Ratovsky [@webron](https://github.com/webron)