Repository navigation
fix(docs): make the operating page front matter valid YAML - #277
Conversation
An unquoted description containing ": " parses as a nested mapping, so Mintlify dropped the page and /run-a-node/operating returned 404. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Deploying website with
|
| Latest commit: |
051aa22
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://ec35b32a.website-70y.pages.dev |
| Branch Preview URL: | https://fix-docs-operating-frontmatt.website-70y.pages.dev |
There was a problem hiding this comment.
🟢 Approval recommended
The one-line reword produces valid YAML front matter, matches the unquoted-description convention used by all other docs pages, and no other file has the same defect.
0 open findings
What changed in this PR
This PR fixes a 404 on https://docs.decdn.org/run-a-node/operating caused by invalid YAML front matter. The page's unquoted description contained : ("…deCDN node: status commands…"), which YAML interprets as a nested mapping, making the front matter invalid so Mintlify drops the page. Prettier, markdownlint, and mintlify broken-links don't parse front matter as YAML, so none caught it. The fix rewords the description to remove the colon, keeping it a valid single-line plain scalar. This complements the run-a-node operator guide added in #276.
Changes:
- Rewords the
operating.mdxfront-matterdescription, replacing the:after "deCDN node" with ", covering" so the YAML parses correctly.
| File | Description |
|---|---|
| docs/run-a-node/operating.mdx | Rewrites the front-matter description to eliminate the colon-space that broke YAML parsing and caused the page's 404. |
🧠 Review effort: Balanced
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Summary
https://docs.decdn.org/run-a-node/operating returns 404, while the other eight run-a-node pages from #276 return 200.
The cause is the page's front matter. Its unquoted
descriptioncontains:("…of a deCDN node: status commands…"), and YAML parses that as a nested mapping, so the front matter is invalid and Mintlify drops the page. Prettier, markdownlint andmintlify broken-linksall pass on it, because none of them parse front matter as YAML. The fix rewords the description so it has no colon.Test plan
docs/**/*.mdxfront matter parses with js-yaml (23 files, 0 errors). The old version fails withbad indentation of a mapping entry.prettier --check🤖 Generated with Claude Code