Add test CI: internal link check and markdownlint - #13
Merged
Conversation
Mirrors the openvox-docs approach. A new test workflow runs two jobs on PRs: html-proofer over the built _site (internal links, images, and scripts only -- external checks are flaky because sites like Slack 403 non-browser clients), and markdownlint-cli2 over tracked Markdown files using the openvox-docs ruleset. The Images/Scripts checks also verify hashed Vite asset paths, so a stale manifest fails CI instead of shipping broken pages. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Signed-off-by: Michael Harp <mike@mikeharp.com>
bastelfreak
approved these changes
Aug 12, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a
test.ymlworkflow with two PR-triggered jobs, mirroring the openvox-docs CI approach:Internal links — builds the site (
npm run build→jekyll build) and runs html-proofer over_sitewith--checks Links,Images,Scripts. External links are deliberately excluded: sites like Slack 403 non-browser clients, which makes external checks flaky in CI (the whole site's external links were verified manually instead). The Images/Scripts checks double as a guard on the Vite manifest lookup — a stale or broken hashed asset path fails CI instead of shipping.Markdown lint — markdownlint-cli2 over git-tracked Markdown files only (so
_site/node_modulescan't leak in), using the openvox-docs ruleset copied in as.markdownlint.yamlfor cross-repo consistency.Supporting changes:
html-proofer ~> 5.0added to the Gemfile's development group with lockfile update.Verified locally: both checks pass green against the current site, and both were confirmed to catch injected breakage (a bad internal link, and lint violations during authoring).
Written with AI assistance (Claude Code); reviewed and verified by me.