Skip to content

Conversation

Copy link

Copilot AI commented Feb 5, 2026

Image Migration Task Plan

  • Create .github/images/ directory
  • Download 20 user-attachments images with descriptive names:
    • 1-step.md: 2 images (codeql-default-configuration, enable-code-scanning)
    • 2-step.md: 8 images (edit-button, codeql-check-progress, code-scan-results, codeql-filter, codeql-setup, matrix-jobs, codeql-jobs-list, python-analysis-logs)
    • 3-step.md: 7 images (code-scanning-tab, additional-info, merge-button, alerts-count, alert-overview, dismiss-alert-options, audit-log-dismissed)
    • 4-step.md: 3 images (edit-button-duplicate, custom-query-pack, query-pack-results)
  • Update markdown references in all .github/steps/*.md files (1-step.md, 2-step.md, 3-step.md, 4-step.md)
  • Update start-exercise workflow version from v0.7.1 to v0.8.0 in .github/workflows/0-start-exercise.yml
  • Verify all images downloaded successfully
  • Verify all relative paths are correct
Original prompt

Image Migration Task: Migrate External Images to Local Repository

Objective

Migrate GitHub user-attachments image references to local repository files in .github/images/ with descriptive filenames and relative links.

Task Steps

1. Find All User-Attachments Image References

Search .github/steps/*.md files for user-attachments image URLs:

  • https://github.com/user-attachments/assets/*

Important: Only migrate user-attachments images. Leave other external images (octodex, img.shields.io, etc.) as absolute URLs.

2. Create Images Directory

mkdir -p .github/images

3. Download and Rename Images

For each user-attachments image:

Download the image:

curl -L "<image-url>" -o ".github/images/<descriptive-name>.png"

Naming convention:

  • Use kebab-case (lowercase with hyphens)
  • Name based on content or alt text
  • Keep it descriptive and clear
  • Preserve original file extension

Examples:

  • Alt text "search box with 'python' value" → python-search-box.png
  • Alt text "target branch settings" → branch-protection-target-settings.png
  • Generic "image" with button context → new-workflow-button.png

Do not download:

  • Octodex images (octodex.github.com)
  • Badge images (img.shields.io)
  • Any other external hosted images

4. Update Markdown References

Replace user-attachments URLs with relative paths:

Find pattern:

src="https://github.com/user-attachments/assets/..."

Replace with:

src="../images/descriptive-filename.png"

Important:

  • Preserve all other attributes (width, alt text, etc.)
  • Do not change other external image URLs (octodex, shields.io, etc.) - keep them as absolute references

5. Verify Changes

  • All user-attachments images downloaded successfully to .github/images/
  • All filenames are descriptive (no generic names or UUIDs)
  • All markdown files updated with relative paths for user-attachments images
  • Relative paths are correct (../images/ from .github/steps/)
  • No broken image links
  • Zero net new files added (only images in .github/images/ should be new)
  • Other external images (octodex, shields.io, etc.) remain as absolute URLs

6. Update start-exercise reusable workflow version

Update start-exercise reusable workflow that is used to v0.8.0 version which is the first release of exercise-toolkit that supports relative links.

Important: Only update the start-exercise version reference. Do not modify any other references to exercise-toolkit elsewhere in the repository.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants