main: schema test coverage #2171

	name: validate-markdown

	# Author: @MikeRalphson
	# Issue: https://github.com/OAI/OpenAPI-Specification/issues/2130

	#
	# This workflow validates files in the versions directory matching 3.*.md
	# Versions before 3.0 are not validated, as they contain linking errors
	# where it is not currently planned to go back and fix them
	#

	# run this on push to any branch and creation of pull-requests
	on: [push, pull_request]

	jobs:
	mdv:

	runs-on: ubuntu-latest

	steps:
	- uses: actions/checkout@v4 # 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@v4 # setup Node.js
	with:
	node-version: '20.x'
	- name: Validate markdown
	run: npx --yes mdv versions/3.*.md
	- name: Lint markdown 3.0.4, 3.1.1, and later
	run: npx --yes markdownlint-cli --config .markdownlint.yaml versions/3.0.4.md versions/3.1.[^0].md versions/3.[2-9].*.md

Provide feedback