Create a RubyGem 90: Fix README to Use Relative Links Instead of Absolute Links @StatelessCode
Create a RubyGem 90: Fix README to Use Relative Links Instead of Absolute Links  @StatelessCode
Uploaded February 2023 | Updated November 2026, 1 hour ago
In one of our videos in the NerdDice.com series, we fixed our CONTRIBUTING.md file to use relative links instead of absolute links and added this item to the NerdDice backlog because there was a similar issue here.

In most cases (with the exception we note below about the CHANGELOG), you want to use relative links in your repository's GitHub Markdown files. That way when you are on a branch working on something, the links will resolve to the file on that branch instead of always pointing back to the master branch.

In our case, there's only one bad link to be fixed. When our build runs on the push, it succeeds, but the benchmark fails on the pull request. Since none of the code related to that benchmark script or any application code changed, we demonstrate how to re-run the failed build to get it passing.

This video covers:
00:00:12 Introduction
00:01:50 Review a similar example commit in the NerdDice.com application with relative links
00:02:18 Demonstrate absolute link to be corrected
00:02:47 Explain reasoning for keeping changelog_uri in gemspec an absolute link to master and plans for CHANGELOG on legacy branches.
00:03:40 Check out a new branch and demonstrate use of GitHub markdown editor and preview
00:05:08 Make the edit to use a relative link
00:05:49 Commit and push the change
00:06:52 Open pull request
00:07:27 Benchmark build fails on pull request, but not push. Re-run failed build and it passes.
00:08:20 Merge and close issue

#ruby #rubygems #codecast #screencast #NerdDice #DnD #roleplaying #softwaredevelopment #github #opensource #dice #TDD #maintain #githubactions #markdown #readme

See other related StatelessCode videos:
- Flesh Out the README for the Project youtu.be/EQioYZAWvGU

This video is CC0 - No rights reserved. (YouTube doesn't allow this option when publishing.) All code is released under the UNLICENSE. Stateless Code denies the concept of "intellectual property". Copying is not stealing.
Create a RubyGem 90: Fix README to Use Relative Links Instead of Absolute LinksCodecast: Getting Started with Rails 7 11: Use a Scaffold Generator to Quickly Produce a ResourceMike From the Future Saves Your Docker SetupUpdate Rails to 7.0.4 and Update the BundleProfessional Level Performance of 433 by John CageCodecast: Getting Started with Rails 7 04: Model CRUD in the Console and Listing ArticlesCodecast: statelesscode.com WordPress 23: Finish Styling Comments Except for FormWrite Browser Tests for Devise Sign UpSet up a GitHub Profile README for an OrganizationCodecast: statelesscode.com WordPress 11: Backlog priority, and Footer Link StylingCodecast: statelesscode.com WordPress 16: Move the Footer Widget Back to the FooterMediocre Karaoke - Better Now by Collective Soul
Stateless Code |

Create a RubyGem 90: Fix README to Use Relative Links Instead of Absolute Links

SHARE TO X SHARE TO REDDIT SHARE TO FACEBOOK WALLPAPER