Skip to content

Fill gaps from assistant conversations: static file 404 troubleshooting - #7051

Merged
ethanpalm merged 2 commits into
mainfrom
mintlify/08b3b204
Aug 21, 2026
Merged

Fill gaps from assistant conversations: static file 404 troubleshooting#7051
ethanpalm merged 2 commits into
mainfrom
mintlify/08b3b204

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

Summary

Add a help center article that walks through why a static file committed to a docs repo can return 404 at its expected URL.

Changes

  • New page help-center/static-file-not-served.mdx covering URL/path mismatch, unsupported file types, size limit, authentication, .mintignore and auto-ignored directories, and redeploy timing.
  • Registered the page in the Help center group in docs.json.

Context

Assistant conversations in the last week included a strongly negatively-rated thread where a user's .json file at the repo root was not being served. Existing coverage in /create/files only lists the auth and 20 MB caveats; users hitting other causes (path mismatch, mintignore, auto-ignored directories, unsupported extension, pre-deploy) had no single troubleshooting entry point. The new page is indexed for search and the assistant but excluded from the sidebar per the help center convention.


Note

Low Risk
Documentation-only addition with no product, auth, or data-handling changes.

Overview
Adds a searchable Help center article that walks users through why a committed static file (JSON, PDF, image, etc.) can return 404 at its expected URL.

The page covers path/case mismatches, unsupported or Enterprise-only extensions, the 20 MB limit, authentication blocking direct file URLs, .mintignore and auto-ignored directories, and needing a successful deploy after adding the file. It is registered in the hidden Help center nav for English, Spanish, French, and Chinese.

Reviewed by Cursor Bugbot for commit 08a46c8. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Aug 21, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
tomee 🟡 Building Aug 21, 2026, 6:12 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@ethanpalm
ethanpalm merged commit c8e979f into main Aug 21, 2026
5 checks passed
@ethanpalm
ethanpalm deleted the mintlify/08b3b204 branch August 21, 2026 22:34
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.

1 participant