Skip to content

Fix 23 broken links in docs/ guides and references#2

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/fix-broken-links-1773965358
Open

Fix 23 broken links in docs/ guides and references#2
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/fix-broken-links-1773965358

Conversation

@mintlify
Copy link

@mintlify mintlify bot commented Mar 20, 2026

Summary

Fixed 23 broken links across 10 files in docs/guides/ and docs/reference/.

What was wrong

All internal links used relative .md paths (e.g., 02-adding-descriptions.md, ../reference/style-guide.md) which Mintlify's link checker cannot resolve. Additionally, 3 links pointed to ../../CONTRIBUTING.md which is excluded from Mintlify via .mintignore.

Fixes applied

File Broken links Fix
docs/guides/01-adding-parameters.md 02-adding-descriptions.md, 03-parameter-exceptions.md Converted to absolute paths (/docs/guides/...)
docs/guides/02-adding-descriptions.md 04-documenting-errors.md, 01-adding-parameters.md Converted to absolute paths
docs/guides/03-parameter-exceptions.md 01-adding-parameters.md, 04-documenting-errors.md Converted to absolute paths
docs/guides/04-documenting-errors.md 02-adding-descriptions.md Converted to absolute path
docs/guides/05-adding-new-endpoints.md 01-adding-parameters.md (x2), 02-adding-descriptions.md, 04-documenting-errors.md Converted to absolute paths
docs/reference/common-pitfalls.md validation.md, ../../CONTRIBUTING.md Absolute path + GitHub URL
docs/reference/file-structure.md quick-reference.md Converted to absolute path
docs/reference/quick-reference.md style-guide.md, file-structure.md, validation.md, common-pitfalls.md Converted to absolute paths
docs/reference/style-guide.md quick-reference.md, common-pitfalls.md, ../../CONTRIBUTING.md Absolute paths + GitHub URL
docs/reference/validation.md ../../CONTRIBUTING.md, common-pitfalls.md GitHub URL + absolute path

Link type conversions

  • Same-directory relative (e.g., 02-adding-descriptions.md) -> absolute Mintlify path (/docs/guides/02-adding-descriptions)
  • Cross-directory relative (e.g., ../reference/style-guide.md) -> absolute Mintlify path (/docs/reference/style-guide)
  • CONTRIBUTING.md (.mintignored) -> GitHub URL (https://github.com/whitebit-exchange/docs/blob/main/CONTRIBUTING.md)

Validation

Both mint validate and mint broken-links pass with zero errors.

Convert relative .md links to absolute Mintlify paths and replace
CONTRIBUTING.md references with GitHub URLs since the file is excluded
from Mintlify via .mintignore.

Generated-By: mintlify-agent
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.

0 participants