Dependency and/or installation instructions update needed?

I get the same error as in #781 when following the [set-up instructions for Mac here](https://carpentries.github.io/lesson-example/setup.html#jekyll-setup-for-lesson-development). The solution given in that thread didn't work for me due to incompatible dependencies. I had to downgrade with `brew install ruby@3.1` to get rid of the error.

However, that solution won't work for long - I get a warning `Warning: ruby@3.1 has been deprecated because it is not supported upstream! It will be disabled on 2026-04-08.`

Does something need updating to support more recent Ruby versions?