Skip to content

Conversation

@torimwhaley
Copy link
Contributor

No description provided.

torimwhaley and others added 2 commits January 16, 2026 13:08
This commit introduces automation to fix image directory issues that can
occur when using the Mintlify Slack app or other tools that don't follow
our image directory conventions.

Changes:
- Add fix-image-locations.js script to automatically move images to
  correct directories and update all MDX references
- Add GitHub Actions workflow to trigger auto-fix via bot
- Enhance validation workflow to show auto-fix instructions when
  image issues are detected
- Add comprehensive documentation in scripts/README.md

Key features:
- Smart handling of single-use vs shared images
- Dry-run mode to preview changes safely
- Automatic reference updates across all files
- Can be triggered manually via GitHub Actions or run locally

This addresses the issue where Mintlify Slack app doesn't respect
our repo's image directory structure rules.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Instead of creating a separate scripts/README.md, integrate the
auto-fix documentation into the existing validation scripts section
of the main README. This keeps all contributor documentation in one
place.

Changes:
- Add auto-fix script documentation to main README
- Update troubleshooting section to reference auto-fix
- Remove separate scripts/README.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@github-actions
Copy link

github-actions bot commented Jan 16, 2026

📋 Documentation Validation Report

⚠️ Some issues were found in this PR. These are informational warnings and will not block merging.

🔗 Links

❌ Found broken links (click to expand)
   📄 guides/test-auto-fix.mdx

🖼️ Images

❌ Found image location issues (click to expand)
   📄 guides/test-auto-fix.mdx:14 → /images/wrong-location/demo-screenshot.png

🤖 Auto-fix Available

Click here to automatically fix these issues

  1. Click "Run workflow"
  2. Enter PR number: 351
  3. Click "Run workflow" button

Changes to the validation bot comment:
- Remove verbose 'Quick Reference' section (not needed if we auto-fix)
- Remove local script instructions (users shouldn't need to run manually)
- Fix broken workflow link (was pointing to wrong URL)
- Simplify to just show auto-fix button with 3 simple steps

Now the comment is much cleaner and more actionable.
This is a test to demonstrate the auto-fix workflow:
- Created guides/test-auto-fix.mdx
- Added image in wrong location (images/wrong-location/)
- Should be in images/guides/test-auto-fix/

The validation bot should detect this and the auto-fix bot
should be able to automatically correct it.
This commit was automatically generated to fix image location issues.
Images have been moved to match the expected directory structure.

Co-Authored-By: GitHub Actions <github-actions[bot]@users.noreply.github.com>
@github-actions
Copy link

🤖 Auto-fix: Image Locations

I've automatically fixed the image location issues in this PR!

Changes Made:

  • Moved images to the correct directory structure
  • Updated all references in MDX files

What was fixed:

Images have been moved to match the expected directory structure where:

  • A page at guides/dashboard.mdx uses images from images/guides/dashboard/
  • Shared images are placed in parent directories

💡 Please review the changes and let me know if everything looks correct!

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.

2 participants