Skip to content

Fix broken links: vendor references/config.md for skill.md - #320

Open
mintlify[bot] wants to merge 8 commits into
masterfrom
mintlify/de397217
Open

mintlify[bot] wants to merge 8 commits into
masterfrom
mintlify/de397217

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Summary

Maintenance fixes found by mint broken-links and mint validate: a broken relative link in skill.md and a recurring MDX parse error in performance/checkpointing.mdx.

Changes

  • Broken link: skill.md (line 45) links to references/config.md with a relative path. The file exists upstream in CerebriumAI/cerebrium-skills but not here, so the link resolved to a non-existent page.
    • Fix: vendored skills/cerebrium/references/config.md from CerebriumAI/cerebrium-skills into references/config.md. The relative link now resolves. skill.md itself is untouched, since the upstream sameness check requires it to stay byte-identical.
    • Added /references/config.md to .prettierignore with a note explaining it is vendored, matching the existing skill.md exemption.
  • Parse error (recurring): the heading-anchor comment added in docs: explain why a checkpoint failed and how to fix it #335 to performance/checkpointing.mdx has been ping-ponging between two broken forms. As an HTML comment (<!-- -->) it fails MDX parsing, and as a JSX comment ({/* */}) the Prettier bot rewrites it to {/_ _/}, which also fails parsing. The Prettified commit after fix: lowercase the skill name in skill.md frontmatter #337 reintroduced the mangled form.
    • Fix: restored the valid JSX comment ({/* ... */}) and added /performance/checkpointing.mdx to .prettierignore with a note, so the Prettier bot stops mangling it. Verified the four agent-linked anchors (#vllm-uses-fork-by-default, #open-gpu-file-descriptors, #cuda-unified-memory, #unknown-cause) still resolve.

Context

Triggered by the merges of #318 (vendored skill.md), #335 (checkpoint failure docs), and the Prettier run after #337. mint validate and mint broken-links both pass.

@mintlify
mintlify Bot requested review from kylegani and milo157 as code owners August 26, 2026 09:21
@mintlify

mintlify Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated
cerebrium 🟢 Ready View Preview Sep 17, 2026, 2:53 PM

This branch was successfully deployed

1 active deployment
staging 3bf6623e Deployed Sep 17, 2026 by mintlify[bot]
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