Update docs or dependencies to include installing webrick

[yuletide]

With a fresh install on mac using chruby, ruby ruby 3.1.3p185 (2022-11-24 revision 1a6b16756e) [arm64-darwin21] (as suggested by jekyll docs) and github-pages (227) the command for jekyll serve fails complaining about missing webrick. Adding this to the Gemfile fixes the issue.

Before submitting an issue, please be sure to

• Read the contributing instructions
• Update to the latest Gem version (run bundle update github-pages)

This issue affects

• The site generated by GitHub Pages
• Building sites locally

The GitHub Pages Gem is intended to help users replicate the GitHub Pages build environment locally. If your issue affects both the hosted version and the version previewed locally, you may be better suited reporting seeking support in other forums.

What did you do (e.g., steps to reproduce)

Followed the docs

What did you expect to happen?

jekyll serve to work

What happened instead?

This error jekyll/jekyll#8523

Additional information

• Link to the live site (if applicable):
• Link to the source repo (if applicable): https://github.com/yuletide/yuletide.github.io

[parkr]

Followed the docs

Which docs, specifically?

[hartsick]

I ran into this same issue following these docs: https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll

[solvaholic]

Duplicate of #752

/cc #752 (comment):

Hi! In general, we recommend (and support) running the github-pages gem with the Ruby version we're running in production (2.7.x). We don't yet support Ruby 3.0.0. Ruby 2.7.x still has webrick so I'd recommend using that until we've upgraded for your GitHub Pages needs!

[janbrasna]

1. https://jekyllrb.com/docs/#instructions has the note since:
   • Add 'webrick' warning note to "Quickstart" Docs jekyll/jekyll#8727
2. https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll#building-your-site-locally has the note since:
   • Add a note for webrick under "Testing your GitHub Pages site locally with Jekyll" docs#21557 and
   • fix: add a note to install the webrick gem for Ruby 3.0 users docs#16137
3. so it's just the readme here like Mention Ruby version support and WEBrick dependency in README.md #881 missing it…

[janbrasna]

This should be resolved as of v232.