Skip to content

fix(docs): redirect edit links for generated .md files to .md.in templates#218

Merged
polaz merged 2 commits intomainfrom
feat/#217-fixdocs-edit-links-point-to-404-for-generated-md-f
Jan 25, 2026
Merged

fix(docs): redirect edit links for generated .md files to .md.in templates#218
polaz merged 2 commits intomainfrom
feat/#217-fixdocs-edit-links-point-to-404-for-generated-md-f

Conversation

@polaz
Copy link
Copy Markdown
Member

@polaz polaz commented Jan 25, 2026

Summary

  • VitePress editLink.pattern now uses a function to detect templated files and redirect to .md.in source
  • Added docs/clients/claude-desktop.md to .gitignore (was missing for generated file)

Affected Pages

All 6 pages generated from .md.in templates now link to correct source:

Page Now links to
/ docs/index.md.in
/guide/ docs/guide/index.md.in
/guide/authentication docs/guide/authentication.md.in
/guide/installation/claude-desktop docs/guide/installation/claude-desktop.md.in
/tools/ docs/tools/index.md.in
/clients/claude-desktop docs/clients/claude-desktop.md.in

Test plan

  • Build docs locally with yarn docs:dev
  • Check "Edit this page on GitHub" link on each affected page
  • Verify links point to .md.in files that exist in repo

Closes #217

…lates

- Add editLink.pattern function to detect templated files and redirect to .md.in source
- Add docs/clients/claude-desktop.md to .gitignore (missing for generated file)

Closes #217
Copilot AI review requested due to automatic review settings January 25, 2026 15:41
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR fixes broken "Edit this page on GitHub" links for documentation pages that are generated from .md.in templates. VitePress was previously generating edit links pointing to non-existent .md files in the repository, resulting in 404 errors.

Changes:

  • Modified VitePress editLink.pattern to use a function that detects templated files and redirects to their .md.in source files
  • Added missing docs/clients/claude-desktop.md to .gitignore for consistency with other generated files

Reviewed changes

Copilot reviewed 1 out of 2 changed files in this pull request and generated no comments.

File Description
docs/.vitepress/config.mts Replaced static edit link pattern with a function that appends .in to paths for the 6 pages generated from .md.in templates
.gitignore Added docs/clients/claude-desktop.md which was missing from the list of generated documentation files

@codecov
Copy link
Copy Markdown

codecov bot commented Jan 25, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@polaz polaz merged commit 2889e23 into main Jan 25, 2026
20 checks passed
@polaz polaz deleted the feat/#217-fixdocs-edit-links-point-to-404-for-generated-md-f branch January 25, 2026 16:00
sw-release-bot bot pushed a commit that referenced this pull request Jan 25, 2026
## [6.47.1](v6.47.0...v6.47.1) (2026-01-25)

### Bug Fixes

* **docs:** redirect edit links for generated .md files to .md.in templates ([#218](#218)) ([2889e23](2889e23)), closes [#217](#217)
@sw-release-bot
Copy link
Copy Markdown

🎉 This PR is included in version 6.47.1 🎉

The release is available on:

Your semantic-release bot 📦🚀

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

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

fix(docs): Edit links point to 404 for generated .md files

2 participants