Skip to content

Fix broken links - #1155

Merged
Doezer merged 1 commit into
mainfrom
mintlify/eae8d0df
Oct 6, 2026
Merged

Doezer merged 1 commit into
mainfrom
mintlify/eae8d0df

Conversation

@mintlify

@mintlify mintlify Bot commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

Summary

Fixes all 54 broken links in 14 files that mint broken-links reported. After the fix, mint validate and mint broken-links both pass.

Changes

  • Links to repo files outside the docs site (for example ../extensions/playnite-questarr/README.md, ../CLAUDE.md, ../GOAL-product.md, ../README.md#home-assistant-add-on, ../.env.example, ../.github/CONTRIBUTING.md, /.github/workflows/*.yml, /.github/dependabot.yml, /Dockerfile, /.zap/rules.tsv, /COPYING, /scripts/*.mjs, /security/vex/questarr.openvex.json): these files are not docs pages, so the site can't resolve them. Each link now points to https://github.com/Doezer/Questarr/blob/main/<path>. I checked that every target file exists in the repo.
    • Files: API, ARCHITECTURE, BEST_PRACTICES, DEPENDENCIES, GITHUB_DOCUMENTATION, HOME_SERVER_APPS, MAINTAINERS, PROXMOX, SBOM, SECRETS, SECURITY_ASSESSMENT, THREAT_MODEL, VEX, VULNERABILITY_MANAGEMENT
  • Links between docs pages that used the /docs/X.md form (/docs/VEX.md, /docs/SBOM.md, /docs/SECURITY_ASSESSMENT.md, /docs/THREAT_MODEL.md, /docs/BEST_PRACTICES.md, /docs/DEPENDENCIES.md, /docs/VULNERABILITY_MANAGEMENT.md#33-...): the /docs/ prefix doesn't exist because the docs site root is docs/. These links now use ./X.md, which works on both the docs site and GitHub. The #33-first-scan-and-current-enforcement-status anchor still resolves.
    • Files: BEST_PRACTICES, SBOM, SECURITY_ASSESSMENT, VEX, VULNERABILITY_MANAGEMENT
  • ./CHANGELOG.md in GITHUB_DOCUMENTATION: CHANGELOG.md is not a docs page in the navigation, so the link didn't resolve. It now points to the GitHub copy of docs/CHANGELOG.md.

@mintlify

mintlify Bot commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
questarr 🟢 Ready View Preview Oct 6, 2026, 7:08 AM

@coderabbitai

coderabbitai Bot commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration
  • Configuration used: Repository UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: b168b1dc-7b42-4126-b632-3e70ef51e1c1

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
  • Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@sonarqubecloud

sonarqubecloud Bot commented Oct 6, 2026

Copy link
Copy Markdown

@Doezer Doezer added bug-fix chore documentation Improvements or additions to documentation labels Oct 6, 2026
@Doezer

Doezer commented Oct 6, 2026

Copy link
Copy Markdown
Owner

wshm · Automated triage by AI

📊 Automated PR Analysis

📝 Type docs
🟢 Risk low

Summary

This PR fixes 54 broken documentation links across 14 docs files flagged by mint broken-links. Links pointing to repo files outside the docs site are rewritten to absolute GitHub URLs, and inter-docs links using the /docs/X.md form are rewritten to relative ./X.md form.

Review Checklist

  • Tests present
  • Breaking change
  • Docs updated

Analyzed automatically by wshm · This is an automated analysis, not a human review.

@Doezer
Doezer merged commit 9df979d into main Oct 6, 2026
6 checks passed
@Doezer
Doezer deleted the mintlify/eae8d0df branch October 6, 2026 11:02

This branch was successfully deployed

1 active deployment
staging - docs — e662d093 Deployed Oct 6, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug-fix chore documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant