Skip to content

chore: upgrade docs to middleman 4.6 (was: nokogiri Ruby compat) - #2928

Merged
kt3k merged 6 commits into
mainfrom
test/ruby-bump
Jul 29, 2026
Merged

chore: upgrade docs to middleman 4.6 (was: nokogiri Ruby compat)#2928
kt3k merged 6 commits into
mainfrom
test/ruby-bump

Conversation

@kt3k

@kt3k kt3k commented Jul 29, 2026

Copy link
Copy Markdown
Member

nokogiri 1.16.5 (#2895) requires Ruby >=3.0 for its precompiled native gem, which conflicted with the docs job's Ruby 2.4.10 pin. Rather than patch around that, this upgrades the whole docs toolchain:

  • middleman 3.2.2 → ~> 4.6 (Ruby >=2.7). Drops the forced compass/sass/coffee-script/sprockets baggage the old middleman meta-gem pulled in — the docs source is plain .haml + prebuilt JS/CSS, so none of that was ever actually used. middleman-core 4.6 brings its own modern sassc/haml/kramdown.
  • Drops middleman-livereload and middleman-sync — neither is activated in config.rb or invoked from any script; they were unused. Removing middleman-sync also removes its fog/fog-xml chain, which is what pulled in nokogiri in the first place — nokogiri isn't part of the dependency tree anymore at all.
  • config.rb: dropped the :ugly haml option (removed in Haml 6, core is unaffected otherwise — asset_hash, :source, :css_dir etc. all work unchanged).
  • CI: bumps the docs job to Ruby 3.1.

Verified locally (bundle exec middleman build) and in this PR's own CI: output structure, page count, and asset hashing all match the previous build.

@kt3k kt3k changed the title test: verify docs job with ruby 2.7 (do not merge) chore: upgrade docs to middleman 4.6 (was: nokogiri Ruby compat) Jul 29, 2026
@kt3k
kt3k merged commit 477b759 into main Jul 29, 2026
2 checks passed
@kt3k
kt3k deleted the test/ruby-bump branch July 29, 2026 08:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant