When developing a { Jekyll, AsciiDoc, Just the Docs } GitHub Pages site, I was pulling my hair out trying to figure out why images weren't rendering when served from GitHub Pages.

Everything looked fine when served locally (bundle exec jekyll serve).
It turns out it's because my source repository is configured with Git LFS - as naturally you would when working with any kind of image source files.
https://github.com/orgs/community/discussions/50337
The solution was to modify the publishing action:
The template project should at least have this in the action as comments.