Update from support feedback: document indexing toggle side effects - #7256
Open
mintlify[bot] wants to merge 2 commits into
Open
Update from support feedback: document indexing toggle side effects#7256mintlify[bot] wants to merge 2 commits into
mintlify[bot] wants to merge 2 commits into
Conversation
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
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.
Summary
Corrects the documented behavior of the Don't index project setting, which gates
llms.txtbut notllms-full.txt(verified in server code), and documents thathidden: trueon a version or other top-level navigation element removes all descendant pages from the site search index. Adds two symptom-named help center articles so users hitting either issue can self-serve. Includes a maintenance pass: French, Spanish, and Chinese translations of all changed pages, mirrored navigation entries, an anchor fix, and an SEO-length description fix.Changes
optimize/seo.mdx: fixed the incorrect claim that the setting 404sllms-full.txt; noted that.mdexports keep their/llms.txtpointer; corrected the#llms-fulltxtanchor.organize/hidden-pages.mdx: new "Hide a version or other top-level navigation element" section, new table row, and a warning that hiding your only version empties site search (versions don't supportsearchable: true).ai/llmstxt.mdx: note that the setting affectsllms.txtbut notllms-full.txt.llms-txt-returns-404-but-llms-full-txt-worksandsite-search-returns-no-results, added to the Help center group indocs.json; shortened the site-search article description to fit the 160-character limit.es/,fr/, andzh/, including the two new translated help center articles and matching entries ines.json,fr.json, andzh.json.Support context
Note
Low Risk
Documentation and navigation-only changes with no application code; risk is limited to doc accuracy and cross-locale consistency.
Overview
This PR updates Mintlify docs to match actual product behavior and add self-serve troubleshooting from support tickets.
Don't index project vs
llms.txt/llms-full.txt: Docs previously said the setting 404s both files. They now state it only returns404forllms.txt(including/.well-known/llms.txt) whilellms-full.txtstays available. Related notes were added on SEO,llms.txt, and a new help article Fix llms.txt returning 404 while llms-full.txt works (pluses/fr/zh).Hidden top-level navigation: Hidden pages now documents
hidden: trueon versions, anchors, dropdowns, languages, and products—including a warning that hiding your only version can empty site search (nosearchable: trueon versions; useseo.indexing: "all"or removehidden). A new help article Fix site search returning no results covers the same symptom.Navigation in
docs.jsonand locale JSON files registers both help center pages.Reviewed by Cursor Bugbot for commit 006662d. Bugbot is set up for automated code reviews on this repo. Configure here.