Skip to content

Bring the README up to date - #15

Merged
excid3 merged 4 commits into
mainfrom
readme-pass
Sep 30, 2026
Merged

excid3 merged 4 commits into
mainfrom
readme-pass

Conversation

@excid3

@excid3 excid3 commented Sep 30, 2026 •

Copy link
Copy Markdown
Member

Documentation only; build fingerprints are unchanged (the series.yml edit is a comment).

  • Intro: what the tarballs are, what's bundled, which distributions they run on
  • Usage: mise setting, plain tarball, asdf; plain-version vs build-revision releases
  • Table of series, versions, bundled OpenSSL and YJIT
  • Rails applications: which Rails each series was deployed with (3.2 on 1.8.7 through 8.1 on 4.0) and what the deploy covered
  • Native gems: bundled headers and static libraries, rbconfig rewritten for the new location, internal functions not linkable from the static libruby, system terminfo (Keep build-tree details out of native gems聽#16)
  • Alongside the system's OpenSSL: what Hide the bundled OpenSSL's symbols from other libraries聽#12 and Stop old openssl extensions clashing with OpenSSL 3, add missing 2.7/3.0/3.1/3.2.0聽#14 do and how it is tested
  • End-of-life Rubies: no longer described as local-development-only; both targets are released; caveats (1.8 wrapper and net/http CA store, preinstalled Bundler/RubyGems, absolute shebangs from old RubyGems, MJIT compiler, Puma on 1.9.3)
  • Build checks, and that PR CI only builds 3.4.1
  • Releases: autobump, rebuilding after a packaging change (only / replace_all)
  • Removed RESEND_API_KEY/NOTIFY_EMAIL (no workflow uses them); corrected the 3.2 baseruby note; credit jdx/ruby
  • Sections for people using the builds now come before the ones for building them

The end-of-life Rubies are no longer local-development-only: Hatchbox installs
them on servers, and they now coexist with the system OpenSSL 3. Document how
to install (mise, asdf, plain tarball), which versions and OpenSSLs exist, the
OpenSSL symbol hiding and how it is tested, and the caveats of the old series.
Drop the Resend secrets no workflow uses, correct the 3.2 baseruby note, and
credit jdx/ruby.
Move the Rails table out of the end-of-life section and extend it to the
supported series, add a Native gems section for what #16 arranged (static
libruby's linkable symbols, rbconfig paths, terminfo), and put the sections
for people using the builds ahead of the ones for building them.
@excid3
excid3 merged commit 0400e21 into main Sep 30, 2026
6 checks passed
@excid3
excid3 deleted the readme-pass branch September 30, 2026 16:30
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