fix: resolve 333 v2 routes missing from docs.json nav coverage#787
Draft
fix: resolve 333 v2 routes missing from docs.json nav coverage#787
Conversation
Co-authored-by: DeveloperAlly <12529822+DeveloperAlly@users.noreply.github.com>
Co-authored-by: DeveloperAlly <12529822+DeveloperAlly@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Update docs.json to include missing v2 routes
fix: resolve 333 v2 routes missing from docs.json nav coverage
Mar 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
333 v2 pages existed on disk but were neither referenced in
docs.jsonnav nor excluded by.mintignore, causing continuous "No docs config" noise in Mintlify dev output.docs.json — add missing routable pages
v2/gateways/using-gateways/gateway-providers→ EN Public Gateways groupinstall-go-livepeer→ Installation grouporch-config→ Configuration groupconnect-to-arbitrum→ Network Integration groupresources-portalanddocumentation-guide/component-library/overviewto each language's Resource HUBget-clip,gateway-setup,configuration-flags,rooms/update-user, etc.).mintignore — exclude non-routable content
/v2/**/x-deprecated/**,/v2/**/x-unstaged/**/v2/**/docs-guide/**/v2/**/README.mdxindex.mdxfiles (about, community, developers, gateways, home, internal, lpt, orchestrators, resources, solutions, es/fr/cn root)es/fr/cn developers/builder-opportunities/**,guides-and-resources/**,journey-mapping.mdxes/fr/cn gateways/about-gateways/**,guides-and-resources/**guides-and-tools//v2/gateways/quickstart/views/**,groups/**/v2/developers/moved-to-about-livepeer-protocol/**/about/go-livepeer/**,api-reference/AI-Worker/**, orphaned CLI-HTTP entries, empty stubspublish/**,v1/**,dual-docker,video-configuration-view,configuration-referenceMOVE ME,Coming Soon,? remove?), empty, or superseded by current nav pagesResult: 0 missing routes (↓ from 333).
Scope
docs.json— ES Solutions tab insertion, targeted page additions, duplicate removal.mintignore— new patterns for non-routable v2 contentValidation
Follow-up Tasks
builder-opportunitiespages to ES/FR/CN Developers tabs (currently mintignored as translation gaps)v2/gateways/references/orchestrator-offerings,go-livepeer/cli-reference, andabout/livepeer-network/livepeer-actors/*— either complete and add to nav or deleteType of Change
Related Issues
Related to #
Changes Made
docs.json(mirrors CN, ~111 pages)resources-portal+component-library/overviewto ES/FR/CN Resource HUBdocs.json.mintignorepatterns covering all 333 previously-noisy routesTesting
npm run devScreenshots (if applicable)
N/A — navigation config change, no visual diff possible without a running Mintlify instance.
Checklist
Additional Notes
The ES Solutions tab was generated programmatically by transforming the CN Solutions tab (replacing
v2/cn/→v2/es/). All 110 of 111 referenced files confirmed to exist on disk; the sole exception (v2/resources/redirect) is a shared stub already used identically in EN/FR/CN nav without issue.Pre-existing duplicates in
docs.json(not introduced by this PR) were cleaned up as part of the same pass.Original prompt
This section details on the original issue you should resolve
<issue_title>docs.json coverage: 333 v2 routes missing from nav</issue_title>
<issue_description>## Summary
Mintlify dev is noisy with repeated "No docs config" errors because a large set of v2 pages exist on disk but are not referenced in
docs.json(mintignore-filtered). This issue tracks the alignment work so we can decide which pages should be routable vs. ignored.What we found
docs.json: 333Recommended next steps
Pick one or more of the following strategies per section:
Full missing route list
Missing routes (mintignore-filtered)