Skip to content

ci(docs): add automated documentation link validation workflow and script (#720) - #725

Open
ravendevhub wants to merge 1 commit into
Core-Foundry:mainfrom
ravendevhub:ci/doc-link-validation-720
Open

ci(docs): add automated documentation link validation workflow and script (#720)#725
ravendevhub wants to merge 1 commit into
Core-Foundry:mainfrom
ravendevhub:ci/doc-link-validation-720

Conversation

@ravendevhub

Copy link
Copy Markdown

Summary

Resolves #720 by introducing an automated markdown link validator script (scripts/check-doc-links.py) and a dedicated GitHub Actions CI workflow (.github/workflows/doc-link-validation.yml) to continuously catch broken internal repository documentation links without failing on external network fluctuations.

Changes

  1. Link Scanner Utility (scripts/check-doc-links.py):
    • Parses Markdown links while stripping code blocks and inline formatting to eliminate false positives.
    • Validates internal relative paths against the workspace filesystem.
    • Excludes external (http://, https://, mailto:) URLs by design to keep CI fast and non-flaky.
    • Supports --warn-only and strict enforcement modes.
  2. GitHub Actions Workflow (.github/workflows/doc-link-validation.yml):
    • Runs automatically on pull requests modifying Markdown documentation files or the scanner script.
  3. Documentation (docs/DOC_LINK_VALIDATION.md):
    • Documents link validation policies and local verification commands.

Acceptance Criteria

  • The workflow is documented.
  • Markdown links are scanned.
  • Broken repository-relative links fail or warn according to project policy.
  • External links can be handled without making CI unnecessarily fragile.

…ript (Core-Foundry#720)

- Add Python markdown link parser checking relative internal file paths
- Safely exclude external http/https/mailto URLs to prevent flaky CI failures
- Create GitHub Actions workflow triggered on Markdown PR changes
- Support --warn-only and strict verification modes
- Document link validation policy in docs/DOC_LINK_VALIDATION.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add CI Job for Documentation Link Validation

1 participant