Skip to content

ci(docs): 🔗 add docs link check - #53

Merged
matteoacrossi merged 16 commits into
mainfrom
matteoacrossi-docs-link-checking
Aug 21, 2026
Merged

ci(docs): 🔗 add docs link check#53
matteoacrossi merged 16 commits into
mainfrom
matteoacrossi-docs-link-checking

Conversation

@matteoacrossi

@matteoacrossi matteoacrossi commented Jul 10, 2026

Copy link
Copy Markdown
Member

Why

Add a link checking step to the Documentation CI, using Lychee.

What changed

  • Kept a single lychee check on built HTML (docs/out/**/*.html) with external links enabled.
  • Added the check-doc-links recipe in justfile.
  • Updated README.md docs commands to match the one-check flow.

Notes for reviewers

  • This change intentionally checks only built output, not source MDX.
  • check-doc-links expects docs/out to already exist (for example after just build-docs).

matteoacrossi and others added 4 commits July 9, 2026 17:19
Add lychee-based docs link checking for both source MDX (internal links) and built HTML output (including external links), and wire both checks into the documentation workflow. Update docs commands in README accordingly.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Roberto Di Remigio Eikås <robertodr@users.noreply.github.com>
@robertodr

Copy link
Copy Markdown
Member

@matteoacrossi are you still interested in getting this merged?

…d settings.json

- Exclude `/benchmarks/*` paths from lychee (public/ assets served at runtime)
- Fix `settings.json` relative link to proper GitHub URL

Assisted-by: GitHubCopilotCodingAgent:claude-sonnet-5

Co-authored-by: robertodr <3708689+robertodr@users.noreply.github.com>
Copilot AI requested a review from robertodr August 5, 2026 18:40
@github-actions github-actions Bot added documentation Improvements or additions to documentation ci labels Aug 20, 2026
matteoacrossi and others added 2 commits August 20, 2026 17:18
Remove source-level docs link checking from justfile and CI, and keep a single lychee pass on built docs HTML. Also simplify README docs commands to the standalone check-doc-links recipe.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@matteoacrossi matteoacrossi changed the title ci(docs): 🔗 add source and post-build docs link checks ci(docs): 🔗 keep only post-build docs link check Aug 20, 2026
@matteoacrossi
matteoacrossi marked this pull request as ready for review August 20, 2026 18:37
@matteoacrossi
matteoacrossi marked this pull request as draft August 20, 2026 18:37
Signed-off-by: Matteo AC Rossi <9745862+matteoacrossi@users.noreply.github.com>
@matteoacrossi

Copy link
Copy Markdown
Member Author

@copilot the three errors raised by lychee in the CI are false positives, add them to the ignore list.

… check

- settings.json GitHub URL: 404 until this branch merges to main
- localhost:3000: dev-server example URL, never reachable in CI
- link.aps.org: APS journal blocks automated crawlers with 403

Assisted-by: GitHubCopilotCodingAgent:claude-sonnet-5

Co-authored-by: matteoacrossi <9745862+matteoacrossi@users.noreply.github.com>

Copilot AI commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

@copilot the three errors raised by lychee in the CI are false positives, add them to the ignore list.

🤖 AI text below 🤖

Done in the latest commit. Added all three to the exclude list in .lychee.postbuild.toml:

  • settings.json GitHub URL — 404 until this branch is merged to main
  • localhost:3000 — dev-server example URL, unreachable in CI
  • link.aps.org — APS journal returns 403 to automated crawlers

@matteoacrossi
matteoacrossi marked this pull request as ready for review August 20, 2026 19:45
@codecov

codecov Bot commented Aug 20, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.70%. Comparing base (7a5505d) to head (6a85efb).
⚠️ Report is 1 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #53   +/-   ##
=======================================
  Coverage   97.70%   97.70%           
=======================================
  Files          14       14           
  Lines         742      742           
  Branches       98       98           
=======================================
  Hits          725      725           
  Misses         12       12           
  Partials        5        5           
Flag Coverage Δ
cpp 97.70% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

@github-actions

Copy link
Copy Markdown

Docs preview: https://pr-53.monoprop-docs.pages.dev

Updated accepted response codes to include 403 for better handling of websites that block crawlers.

Signed-off-by: Matteo AC Rossi <9745862+matteoacrossi@users.noreply.github.com>
@matteoacrossi
matteoacrossi enabled auto-merge (squash) August 21, 2026 08:27
@matteoacrossi matteoacrossi changed the title ci(docs): 🔗 keep only post-build docs link check ci(docs): 🔗 add docs link check Aug 21, 2026
Signed-off-by: Matteo AC Rossi <9745862+matteoacrossi@users.noreply.github.com>
@matteoacrossi
matteoacrossi merged commit 668c90b into main Aug 21, 2026
23 checks passed
@matteoacrossi
matteoacrossi deleted the matteoacrossi-docs-link-checking branch August 21, 2026 08:44
@sonarqubecloud

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants