Dependency Status Report

Last Updated: November 30, 2025

Current Status

This project uses GitHub Pages for hosting, which constrains us to specific dependency versions for compatibility and stability.

GitHub Pages Version

• Current: 232
• Latest: 232
• Status: ✅ Up to date

Ruby Version

• Current: 3.4.4
• Status: ✅ Latest stable version

Jekyll Version

• Current: 3.10.0 (locked by GitHub Pages)
• Latest Available: 4.4.1
• Status: ⚠️ Major version behind (constrained by GitHub Pages)

Note: GitHub Pages intentionally uses Jekyll 3.x for backward compatibility. Jekyll 4.x has breaking changes that would affect many existing sites.

Dependency Categories

1. GitHub Pages Controlled Dependencies

These versions are locked by GitHub Pages and should not be manually updated:

Gem	Current	Latest	Status
jekyll	3.10.0	4.4.1	🔒 Locked by GH Pages
liquid	4.0.4	5.11.0	🔒 Locked by GH Pages
rouge	3.30.0	4.6.1	🔒 Locked by GH Pages
kramdown	2.4.0	2.5.1	🔒 Locked by GH Pages
jekyll-sass-converter	1.5.2	3.1.0	🔒 Locked by GH Pages
jekyll-commonmark-ghpages	0.5.1	0.5.1	✅ Current

2. Our Explicit Dependencies

These match GitHub Pages 231 requirements:

Gem	Current	Status
jekyll-feed	0.17.0	✅ Matches GH Pages
jekyll-sitemap	1.4.0	✅ Matches GH Pages
jekyll-seo-tag	2.8.0	✅ Matches GH Pages
jekyll-paginate	1.1.0	✅ Matches GH Pages
jekyll-gist	1.5.0	✅ Matches GH Pages
jemoji	0.13.0	✅ Matches GH Pages
jekyll-include-cache	0.2.0	✅ Matches GH Pages

3. Runtime Dependencies

These can be updated independently:

Gem	Current	Latest	Update Available
webrick	1.9.2	1.9.2	✅ Current
csv	3.0.0+	3.0.0+	✅ Current
faraday-retry	2.2.0+	2.2.0+	✅ Current

4. Theme

Component	Current	Latest	Status
minimal-mistakes	4.26.2	4.26.2	✅ Current

Recommendations

✅ All Safe Updates Applied

Last Updated: November 30, 2025

All recommended updates have been successfully applied:

1. ✅ GitHub Pages updated to 232
   • Jekyll upgraded from 3.9.5 to 3.10.0
   • jekyll-commonmark-ghpages upgraded from 0.4.0 to 0.5.1

2. ✅ Minimal Mistakes theme updated to 4.26.2

3. ✅ Webrick updated to 1.9.2

Next recommended update: Check again in 3-6 months (March 2026)

⚠️ Cannot Update (GitHub Pages Constraints)

The following are locked by GitHub Pages and will only update when GitHub Pages updates:

• Jekyll (stuck at 3.9.5)
• Liquid (stuck at 4.0.4)
• Rouge (stuck at 3.30.0)
• Kramdown (stuck at 2.4.0)
• Jekyll Sass Converter (stuck at 1.5.2)

🔄 Alternative: Migrate Off GitHub Pages

If you need the latest versions, consider migrating to:

1. GitHub Actions + Jekyll 4.x + GitHub Pages deployment
   • Gives you full control over Jekyll and plugin versions
   • Still deploys to GitHub Pages, just builds differently
   • Requires .github/workflows/jekyll.yml configuration
2. Netlify or Vercel
   • Full control over build environment
   • Faster builds
   • More features (redirects, headers, etc.)
3. Self-hosted
   • Complete control
   • Requires server management

Update Strategy

Current Approach (Recommended for Stability)

✅ Stay with GitHub Pages gem: This ensures your site builds reliably on GitHub’s servers without any compatibility issues.

Update frequency: Every 3-6 months when new GitHub Pages versions are released.

Alternative Approach (For Latest Features)

If you need Jekyll 4.x features or latest plugin versions:

1. Remove github-pages gem
2. Add individual Jekyll and plugin gems
3. Set up GitHub Actions for building
4. Deploy built site to GitHub Pages

Security Considerations

• ✅ All dependencies are receiving security updates
• ✅ GitHub Pages team actively maintains their gem versions
• ✅ No known critical vulnerabilities in current versions
• ⚠️ Some dependencies are several major versions behind, but this is acceptable for a static site generator

Testing Updates

Before applying any updates:

1. Check the changelog for breaking changes
2. Test locally with bundle exec ruby jekyll_wrapper.rb serve
3. Check for build warnings or errors
4. Verify all pages render correctly
5. Test on a branch before merging to main

Resources

• GitHub Pages Dependency Versions
• Jekyll Upgrade Guide
• Minimal Mistakes Changelog
• GitHub Pages Documentation

---

Last Checked: November 30, 2025
Next Review: March 2026