Skip to content

fix: move all docs images out of broken /images/ CDN path - #445

Closed
Nikhil (shadowfax92) wants to merge 1 commit into
mainfrom
fix/all-docs-images
Closed

fix: move all docs images out of broken /images/ CDN path#445
Nikhil (shadowfax92) wants to merge 1 commit into
mainfrom
fix/all-docs-images

Conversation

@shadowfax92

Copy link
Copy Markdown
Contributor

Summary

  • All images on docs.browseros.com are broken — Mintlify CDN serves 130-byte placeholder PNGs for every file in the docs/images/ directory
  • Images co-located with MDX files (e.g. features/workflow/, features/cowork/) use different CDN upload paths and render correctly
  • This PR moves all referenced images to co-located directories alongside their MDX files, and removes the entire docs/images/ directory
  • Also fixes the Slack link placeholder (SLACK_LINK_HERE → actual URL) in the troubleshooting page

Files changed

  • 15 MDX files updated with new image paths
  • 37 images moved to co-located directories
  • 83 orphaned images removed (unreferenced files in docs/images/)
  • 145 files total

Image relocation mapping

MDX file Images moved to
changelog.mdx docs/changelog/
index.mdx docs/ (root)
contributing.mdx docs/contributing/
features/bring-your-own-llm.mdx docs/features/bring-your-own-llm/
features/local-models.mdx docs/features/local-models/
features/*.mdx (others) docs/features/
integrations/n8n.mdx docs/integrations/
troubleshooting/connection-issues.mdx docs/troubleshooting/
update/*.mdx docs/update/

Known pre-existing issues (not introduced by this PR)

  • features/soul.mdx references /features/soul-settings.png — image file doesn't exist
  • features/connect-mcps.mdx references /features/connect-apps-smart-connection.png — image file doesn't exist

Test plan

  • Verify all images render on every docs page after deploy
  • Spot-check: homepage hero, BYOLLM setup screenshots, changelog images, troubleshooting page
  • Confirm no 404s in browser console on any docs page

🤖 Generated with Claude Code

Mintlify CDN serves 130-byte placeholder PNGs for all files in
docs/images/, making every image across the site broken. Images
co-located with MDX files (e.g. features/workflow/) use different
CDN upload paths and render correctly.

This moves all referenced images to co-located directories matching
their MDX files and removes the entire docs/images/ directory.
Also fixes the Slack link placeholder in troubleshooting page.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@greptile-apps

greptile-apps Bot commented Mar 15, 2026

Copy link
Copy Markdown
Contributor

Too many files changed for review. (145 files found, 100 file limit)

@github-actions github-actions Bot locked and limited conversation to collaborators Mar 16, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant