Skip to content

docs: use absolute GitHub URLs for README images#235

Merged
kevinccbsg merged 1 commit into
mainfrom
docs/absolute-image-urls
May 1, 2026
Merged

docs: use absolute GitHub URLs for README images#235
kevinccbsg merged 1 commit into
mainfrom
docs/absolute-image-urls

Conversation

@kevinccbsg
Copy link
Copy Markdown
Member

Summary

Replaces relative paths in README.md with absolute URLs so they render reliably across github.com, npmjs.com, and any other markdown viewer that doesn't auto-rewrite relative paths.

Changes

Before After
./images/twd-skill.gif https://raw.githubusercontent.com/BRIKEV/twd/main/images/twd-skill.gif
./images/twd_side_bar_success.png https://raw.githubusercontent.com/BRIKEV/twd/main/images/twd_side_bar_success.png
[Examples Directory](./examples) [Examples Directory](https://github.com/BRIKEV/twd/tree/main/examples)

Why

The images/ folder is not in the npm tarball ("files": ["dist", "README.md", "LICENSE"] excludes it). The previous relative paths only rendered correctly when npmjs.com auto-rewrote them via the repository field — which works most of the time but had a propagation delay around the 1.7.3 release that briefly showed broken images. Absolute URLs eliminate that dependency.

The contributor avatars in this README already use absolute URLs to avatars.githubusercontent.com — this brings the GIF and screenshot in line with that pattern.

Test plan

  • No code changes; README-only
  • Visual verification on the PR's "Files changed" tab — images render
  • Will be folded into the next release (no urgent republish; 1.7.3 already renders fine via npm's auto-rewrite once propagation completed)

🤖 Generated with Claude Code

Replaces relative paths (./images/*, ./examples) with absolute URLs
to raw.githubusercontent.com and github.com respectively. This
hardens the README against any npm CDN/rewrite oddities so the GIF,
screenshot, and examples link work uniformly on github.com,
npmjs.com, and any other markdown renderer.

No code/dist changes — README only.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@kevinccbsg kevinccbsg merged commit b4278d4 into main May 1, 2026
9 checks passed
@kevinccbsg kevinccbsg deleted the docs/absolute-image-urls branch May 1, 2026 21:28
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