Jekyll Upgrade Notes

Changes Made

1. Ruby Version Update

• Created .ruby-version file specifying Ruby 3.3.10
• Previous: Ruby 2.6.10
• New: Ruby 3.3.10 (currently installing)

2. Gemfile Updates

• Changed Jekyll from development version to stable release
  • Previous: gem "jekyll", github: "jekyll/jekyll" (development/edge version)
  • New: gem "jekyll", "~> 4.3" (latest stable version 4.3.x)
• Added webrick gem (required for Ruby 3.0+)
  • gem "webrick", "~> 1.8"

3. Next Steps

Once Ruby 3.3.10 installation completes:

1. Run bundle install to install all gems with the new Ruby version
2. Run bundle update to update all dependencies to their latest compatible versions
3. Test the blog locally with bundle exec jekyll serve
4. Check for any deprecation warnings or compatibility issues

Compatibility Notes

• Jekyll 4.3.x is compatible with Ruby 3.0+
• All existing plugins should work with Jekyll 4.3
• The CommonMark markdown parser is still supported
• All custom layouts and includes should continue to work

Rollback Instructions

If issues occur:

1. Revert .ruby-version to use Ruby 2.6.10 (or remove the file)
2. Revert Gemfile changes:
   • Change back to gem "jekyll", github: "jekyll/jekyll"
   • Remove the webrick gem line
3. Run bundle install