Skip to content

Migrate user-attachments images to local repository with relative paths#64

Merged
FidelusAleksander merged 4 commits intomainfrom
copilot/migrate-external-images
Feb 12, 2026
Merged

Migrate user-attachments images to local repository with relative paths#64
FidelusAleksander merged 4 commits intomainfrom
copilot/migrate-external-images

Conversation

Copy link
Contributor

Copilot AI commented Feb 6, 2026

Migrates GitHub-hosted user-attachments images to local .github/images/ directory with descriptive filenames and relative references. Updates start-exercise workflow to v0.8.1 for relative link support.

Changes

  • Images migrated: 2 user-attachments images downloaded to .github/images/

    • dadjoke-mona.png (2.4M) - Dad joke mascot from step 1
    • joke-action-workflow-run.png (16K) - Workflow run screenshot from step 6
  • Markdown updates: Updated .github/steps/{1,6}-step.md to use relative paths (../images/) with descriptive alt text for accessibility

  • Workflow version: Bumped start-exercise reusable workflow from v0.7.3 → v0.8.1 in 0-start-exercise.yml

  • Workflow configuration: Added explicit ref: main to Checkout step in post_next_step_content job to ensure latest commits from start-exercise workflow are used

External images (octodex, shields.io) remain as absolute URLs per requirement.

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.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

…exercise to v0.8.0

Co-authored-by: FidelusAleksander <63016446+FidelusAleksander@users.noreply.github.com>
Copilot AI changed the title [WIP] Migrate external images to local repository Migrate user-attachments images to local repository with relative paths Feb 6, 2026
@FidelusAleksander FidelusAleksander marked this pull request as ready for review February 6, 2026 12:58
Copilot AI review requested due to automatic review settings February 6, 2026 12:58
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Migrates GitHub user-attachments image references in exercise step content to locally committed images under .github/images/, enabling stable rendering via relative paths supported by the updated start-exercise workflow.

Changes:

  • Bumped skills/exercise-toolkit start-exercise reusable workflow from v0.7.3 to v0.8.0.
  • Updated step markdown files to reference images via ../images/... relative paths.
  • Added the migrated images to .github/images/ with descriptive filenames.

Reviewed changes

Copilot reviewed 3 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
.github/workflows/0-start-exercise.yml Updates start-exercise workflow ref to a version that supports relative links.
.github/steps/1-step.md Replaces user-attachments image URL with a local relative path.
.github/steps/6-step.md Replaces user-attachments image URL with a local relative path.
.github/images/dadjoke-mona.png Adds locally hosted image for step 1 content.
.github/images/joke-action-workflow-run.png Adds locally hosted screenshot for step 6 content.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@FidelusAleksander
Copy link
Contributor

@copilot Two tasks for you

  1. Update start-exercise reusable workflow that is used to v0.8.1 version

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

  1. Ensure that the repository is checked out at the main branch during the "Checkout" step in the .github/workflows/0-start-exercise.yml file in the post_next_step_content job

This will ensure the current repository is checked out with the commit that was pushed by the previous start-exercise reusable workflow

Co-authored-by: FidelusAleksander <63016446+FidelusAleksander@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Feb 10, 2026

@copilot Two tasks for you

  1. Update start-exercise reusable workflow that is used to v0.8.1 version

...

Done! Both tasks completed in commit a3bcc70:

  1. Updated start-exercise reusable workflow version from v0.8.0 to v0.8.1
  2. Added explicit ref: main to the Checkout step in the post_next_step_content job

@FidelusAleksander FidelusAleksander merged commit fd2a473 into main Feb 12, 2026
2 checks passed
@FidelusAleksander FidelusAleksander deleted the copilot/migrate-external-images branch February 12, 2026 14:16
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.

3 participants