texd 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7b96f50cf6e5741a667f9f0bdb41d6e781c50a6d1a67b4637f1c4e1e12a45176
-  data.tar.gz: 15028be97e8a7e86025998dc54cb8e502976dd3752bc88f68b55dac32309e4ed
+  metadata.gz: f1a1c4b4906b676b7984b8de4ea61dc5821d03cd107ba9d8b6dc27f61f1724e5
+  data.tar.gz: c62530f487753e892469fac3f4896f393e8c61e9f742f24374b66da30b010ace
 SHA512:
-  metadata.gz: d5a1f0f363874f090a28ced8d90a13ebcab331b3410833304ea0f5273143668b8e89e227a94045547badf0fcdf6dd7690f565272501e72b0b13764c8e673c530
-  data.tar.gz: 513fc1c93cbcab5941eda498453f23914149314709b8d67738470a43f6c4fbc65cf0c636ab2148f8872155b2562e6df4f79f9c29a09b7052e92ca61f1fb3c0b9
+  metadata.gz: b7f7b16b12431596186fdd0545442b5962efb16c8c01ad55a834442123b0200925bd5cbe0d3f2b4c3ce3f2dfde7d5e68b21b7418c9e715ea6f97b5befcc48612
+  data.tar.gz: c8003cddafe5187fe8726f4259847b7d229890250577d8e93261e14870f345a669320e530a2ab611f350aca8d17891b1447ba01edd9e2cb580bd063f9fafe661

data/.rubocop.yml

@@ -1,3 +1,8 @@
+require:
+  - rubocop-rails
+  - rubocop-rake
+  - rubocop-rspec
+
 AllCops:
   DisplayCopNames: true
   StyleGuideCopsOnly: false
@@ -329,8 +334,16 @@ Style/TrailingCommaInArrayLiteral:
 Style/TrailingCommaInHashLiteral:
   EnforcedStyleForMultiline: comma
 
+Style/SuperWithArgsParentheses:
+  Enabled: false # cop doesn't provide a preferred style option
+
 ## RSpec Cops - https://docs.rubocop.org/rubocop-rspec/cops_rspec.html
 
+RSpec:
+  Language:
+    Expectations:
+      - expect_escape
+
 RSpec/ExampleLength:
   Max: 10
   CountAsOne: [array, hash, heredoc]

data/CHANGELOG.md

@@ -1,6 +1,40 @@
 ## Unreleased
 
-[Compare changes](https://github.com/digineo/texd-ruby/compare/v0.5.0...master)
+[Compare changes](https://github.com/digineo/texd-ruby/compare/v0.6.0...master)
+
+## v0.6.0 - 2024-02-13
+
+**Changes**
+
+- Add another optional argument to the `escape` helper, to disallow replacing
+  of hyphens.
+
+  Previously, `escape(str, typographic: true)` did replace the hyphen between
+  word-characters with `"=` (i.e. the babel shorthand for a hard-hyphen in German
+  locale).
+
+  Now it is possible to disable the hyphenation replacement explicitly:
+
+  ```erb
+  <%= escape str, hyphenation: false %>
+  ```
+
+  The default value for the `hyphenation` option defaults to the value given to
+  the `typographic` option (which in turn is true by default).
+
+
+[Compare changes](https://github.com/digineo/texd-ruby/compare/v0.5.1...v0.6.0)
+
+## v0.5.1 - 2022-10-10
+
+**Changes**
+
+This is a maintenance release. Expect full compatability with v0.5.0.
+
+- update dependencies
+- add specs for rails/main
+
+[Compare changes](https://github.com/digineo/texd-ruby/compare/v0.5.0...v0.5.1)
 
 ## v0.5.0 - 2022-07-22
 

data/Gemfile

@@ -3,6 +3,7 @@
 source "https://rubygems.org"
 gemspec
 
+gem "nokogiri", "~> 1.15.5" # remove constraint when min. RUBY_VERSION >= 3
 gem "pry-byebug"
 gem "rails", "~> 7.0"
 
@@ -14,3 +15,11 @@ group :development do
   gem "rubocop-rake"
   gem "rubocop-rspec"
 end
+
+# keep in sync with gemfiles/*/Gemfile
+group :development, :test do
+  gem "combustion"
+  gem "rake", "~> 13.0"
+  gem "rspec", "~> 3.0"
+  gem "rspec-rails"
+end

data/Gemfile.lock

@@ -1,225 +1,266 @@
 PATH
   remote: .
   specs:
-    texd (0.5.0)
+    texd (0.6.0)
       multipart-post (~> 2.0)
       rails (>= 6.0, < 8)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    actioncable (7.0.3.1)
-      actionpack (= 7.0.3.1)
-      activesupport (= 7.0.3.1)
+    actioncable (7.1.3)
+      actionpack (= 7.1.3)
+      activesupport (= 7.1.3)
       nio4r (~> 2.0)
       websocket-driver (>= 0.6.1)
-    actionmailbox (7.0.3.1)
-      actionpack (= 7.0.3.1)
-      activejob (= 7.0.3.1)
-      activerecord (= 7.0.3.1)
-      activestorage (= 7.0.3.1)
-      activesupport (= 7.0.3.1)
+      zeitwerk (~> 2.6)
+    actionmailbox (7.1.3)
+      actionpack (= 7.1.3)
+      activejob (= 7.1.3)
+      activerecord (= 7.1.3)
+      activestorage (= 7.1.3)
+      activesupport (= 7.1.3)
       mail (>= 2.7.1)
       net-imap
       net-pop
       net-smtp
-    actionmailer (7.0.3.1)
-      actionpack (= 7.0.3.1)
-      actionview (= 7.0.3.1)
-      activejob (= 7.0.3.1)
-      activesupport (= 7.0.3.1)
+    actionmailer (7.1.3)
+      actionpack (= 7.1.3)
+      actionview (= 7.1.3)
+      activejob (= 7.1.3)
+      activesupport (= 7.1.3)
       mail (~> 2.5, >= 2.5.4)
       net-imap
       net-pop
       net-smtp
-      rails-dom-testing (~> 2.0)
-    actionpack (7.0.3.1)
-      actionview (= 7.0.3.1)
-      activesupport (= 7.0.3.1)
-      rack (~> 2.0, >= 2.2.0)
+      rails-dom-testing (~> 2.2)
+    actionpack (7.1.3)
+      actionview (= 7.1.3)
+      activesupport (= 7.1.3)
+      nokogiri (>= 1.8.5)
+      racc
+      rack (>= 2.2.4)
+      rack-session (>= 1.0.1)
       rack-test (>= 0.6.3)
-      rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.0, >= 1.2.0)
-    actiontext (7.0.3.1)
-      actionpack (= 7.0.3.1)
-      activerecord (= 7.0.3.1)
-      activestorage (= 7.0.3.1)
-      activesupport (= 7.0.3.1)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+    actiontext (7.1.3)
+      actionpack (= 7.1.3)
+      activerecord (= 7.1.3)
+      activestorage (= 7.1.3)
+      activesupport (= 7.1.3)
       globalid (>= 0.6.0)
       nokogiri (>= 1.8.5)
-    actionview (7.0.3.1)
-      activesupport (= 7.0.3.1)
+    actionview (7.1.3)
+      activesupport (= 7.1.3)
       builder (~> 3.1)
-      erubi (~> 1.4)
-      rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.1, >= 1.2.0)
-    activejob (7.0.3.1)
-      activesupport (= 7.0.3.1)
+      erubi (~> 1.11)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+    activejob (7.1.3)
+      activesupport (= 7.1.3)
       globalid (>= 0.3.6)
-    activemodel (7.0.3.1)
-      activesupport (= 7.0.3.1)
-    activerecord (7.0.3.1)
-      activemodel (= 7.0.3.1)
-      activesupport (= 7.0.3.1)
-    activestorage (7.0.3.1)
-      actionpack (= 7.0.3.1)
-      activejob (= 7.0.3.1)
-      activerecord (= 7.0.3.1)
-      activesupport (= 7.0.3.1)
+    activemodel (7.1.3)
+      activesupport (= 7.1.3)
+    activerecord (7.1.3)
+      activemodel (= 7.1.3)
+      activesupport (= 7.1.3)
+      timeout (>= 0.4.0)
+    activestorage (7.1.3)
+      actionpack (= 7.1.3)
+      activejob (= 7.1.3)
+      activerecord (= 7.1.3)
+      activesupport (= 7.1.3)
       marcel (~> 1.0)
-      mini_mime (>= 1.1.0)
-    activesupport (7.0.3.1)
+    activesupport (7.1.3)
+      base64
+      bigdecimal
       concurrent-ruby (~> 1.0, >= 1.0.2)
+      connection_pool (>= 2.2.5)
+      drb
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
+      mutex_m
       tzinfo (~> 2.0)
     ast (2.4.2)
+    base64 (0.2.0)
+    bigdecimal (3.1.6)
     builder (3.2.4)
     byebug (11.1.3)
     coderay (1.1.3)
-    combustion (1.3.7)
+    combustion (1.4.0)
       activesupport (>= 3.0.0)
       railties (>= 3.0.0)
       thor (>= 0.14.6)
-    concurrent-ruby (1.1.10)
+    concurrent-ruby (1.2.3)
+    connection_pool (2.4.1)
     crass (1.0.6)
-    diff-lcs (1.5.0)
-    digest (3.1.0)
-    erubi (1.10.0)
-    globalid (1.0.0)
-      activesupport (>= 5.0)
-    i18n (1.12.0)
+    date (3.3.4)
+    diff-lcs (1.5.1)
+    drb (2.2.0)
+      ruby2_keywords
+    erubi (1.12.0)
+    globalid (1.2.1)
+      activesupport (>= 6.1)
+    i18n (1.14.1)
       concurrent-ruby (~> 1.0)
-    json (2.6.2)
-    loofah (2.18.0)
+    io-console (0.7.2)
+    irb (1.11.2)
+      rdoc
+      reline (>= 0.4.2)
+    json (2.7.1)
+    language_server-protocol (3.17.0.3)
+    loofah (2.22.0)
       crass (~> 1.0.2)
-      nokogiri (>= 1.5.9)
-    mail (2.7.1)
+      nokogiri (>= 1.12.0)
+    mail (2.8.1)
       mini_mime (>= 0.1.1)
+      net-imap
+      net-pop
+      net-smtp
     marcel (1.0.2)
     method_source (1.0.0)
-    mini_mime (1.1.2)
-    mini_portile2 (2.8.0)
-    minitest (5.16.2)
-    multipart-post (2.2.3)
-    net-imap (0.2.3)
-      digest
+    mini_mime (1.1.5)
+    mini_portile2 (2.8.5)
+    minitest (5.22.2)
+    multipart-post (2.4.0)
+    mutex_m (0.2.0)
+    net-imap (0.4.10)
+      date
       net-protocol
-      strscan
-    net-pop (0.1.1)
-      digest
+    net-pop (0.1.2)
       net-protocol
+    net-protocol (0.2.2)
       timeout
-    net-protocol (0.1.3)
-      timeout
-    net-smtp (0.3.1)
-      digest
+    net-smtp (0.4.0.1)
       net-protocol
-      timeout
-    nio4r (2.5.8)
-    nokogiri (1.13.7)
-      mini_portile2 (~> 2.8.0)
+    nio4r (2.7.0)
+    nokogiri (1.15.5)
+      mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
-    nokogiri (1.13.7-x86_64-linux)
+    nokogiri (1.15.5-x86_64-linux)
       racc (~> 1.4)
-    parallel (1.22.1)
-    parser (3.1.2.0)
+    parallel (1.24.0)
+    parser (3.3.0.5)
       ast (~> 2.4.1)
-    pry (0.13.1)
+      racc
+    pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    pry-byebug (3.9.0)
+    pry-byebug (3.10.1)
       byebug (~> 11.0)
-      pry (~> 0.13.0)
-    racc (1.6.0)
-    rack (2.2.4)
-    rack-test (2.0.2)
+      pry (>= 0.13, < 0.15)
+    psych (5.1.2)
+      stringio
+    racc (1.7.3)
+    rack (3.0.9)
+    rack-session (2.0.0)
+      rack (>= 3.0.0)
+    rack-test (2.1.0)
       rack (>= 1.3)
-    rails (7.0.3.1)
-      actioncable (= 7.0.3.1)
-      actionmailbox (= 7.0.3.1)
-      actionmailer (= 7.0.3.1)
-      actionpack (= 7.0.3.1)
-      actiontext (= 7.0.3.1)
-      actionview (= 7.0.3.1)
-      activejob (= 7.0.3.1)
-      activemodel (= 7.0.3.1)
-      activerecord (= 7.0.3.1)
-      activestorage (= 7.0.3.1)
-      activesupport (= 7.0.3.1)
+    rackup (2.1.0)
+      rack (>= 3)
+      webrick (~> 1.8)
+    rails (7.1.3)
+      actioncable (= 7.1.3)
+      actionmailbox (= 7.1.3)
+      actionmailer (= 7.1.3)
+      actionpack (= 7.1.3)
+      actiontext (= 7.1.3)
+      actionview (= 7.1.3)
+      activejob (= 7.1.3)
+      activemodel (= 7.1.3)
+      activerecord (= 7.1.3)
+      activestorage (= 7.1.3)
+      activesupport (= 7.1.3)
       bundler (>= 1.15.0)
-      railties (= 7.0.3.1)
-    rails-dom-testing (2.0.3)
-      activesupport (>= 4.2.0)
+      railties (= 7.1.3)
+    rails-dom-testing (2.2.0)
+      activesupport (>= 5.0.0)
+      minitest
       nokogiri (>= 1.6)
-    rails-html-sanitizer (1.4.3)
-      loofah (~> 2.3)
-    railties (7.0.3.1)
-      actionpack (= 7.0.3.1)
-      activesupport (= 7.0.3.1)
-      method_source
+    rails-html-sanitizer (1.6.0)
+      loofah (~> 2.21)
+      nokogiri (~> 1.14)
+    railties (7.1.3)
+      actionpack (= 7.1.3)
+      activesupport (= 7.1.3)
+      irb
+      rackup (>= 1.0.0)
       rake (>= 12.2)
-      thor (~> 1.0)
-      zeitwerk (~> 2.5)
+      thor (~> 1.0, >= 1.2.2)
+      zeitwerk (~> 2.6)
     rainbow (3.1.1)
-    rake (13.0.6)
-    regexp_parser (2.5.0)
-    rexml (3.2.5)
-    rspec (3.11.0)
-      rspec-core (~> 3.11.0)
-      rspec-expectations (~> 3.11.0)
-      rspec-mocks (~> 3.11.0)
-    rspec-core (3.11.0)
-      rspec-support (~> 3.11.0)
-    rspec-expectations (3.11.0)
+    rake (13.1.0)
+    rdoc (6.6.2)
+      psych (>= 4.0.0)
+    regexp_parser (2.9.0)
+    reline (0.4.2)
+      io-console (~> 0.5)
+    rexml (3.2.6)
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.0)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-mocks (3.11.1)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-rails (5.1.2)
-      actionpack (>= 5.2)
-      activesupport (>= 5.2)
-      railties (>= 5.2)
-      rspec-core (~> 3.10)
-      rspec-expectations (~> 3.10)
-      rspec-mocks (~> 3.10)
-      rspec-support (~> 3.10)
-    rspec-support (3.11.0)
-    rubocop (1.32.0)
+      rspec-support (~> 3.13.0)
+    rspec-rails (6.1.1)
+      actionpack (>= 6.1)
+      activesupport (>= 6.1)
+      railties (>= 6.1)
+      rspec-core (~> 3.12)
+      rspec-expectations (~> 3.12)
+      rspec-mocks (~> 3.12)
+      rspec-support (~> 3.12)
+    rspec-support (3.13.0)
+    rubocop (1.60.2)
       json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
-      parser (>= 3.1.0.0)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.19.1, < 2.0)
+      rubocop-ast (>= 1.30.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.19.1)
-      parser (>= 3.1.1.0)
-    rubocop-rails (2.15.2)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.30.0)
+      parser (>= 3.2.1.0)
+    rubocop-capybara (2.20.0)
+      rubocop (~> 1.41)
+    rubocop-factory_bot (2.25.1)
+      rubocop (~> 1.41)
+    rubocop-rails (2.23.1)
       activesupport (>= 4.2.0)
       rack (>= 1.1)
-      rubocop (>= 1.7.0, < 2.0)
+      rubocop (>= 1.33.0, < 2.0)
+      rubocop-ast (>= 1.30.0, < 2.0)
     rubocop-rake (0.6.0)
       rubocop (~> 1.0)
-    rubocop-rspec (2.12.1)
-      rubocop (~> 1.31)
-    ruby-progressbar (1.11.0)
-    strscan (3.0.3)
-    thor (1.2.1)
-    timeout (0.3.0)
-    tzinfo (2.0.5)
+    rubocop-rspec (2.26.1)
+      rubocop (~> 1.40)
+      rubocop-capybara (~> 2.17)
+      rubocop-factory_bot (~> 2.22)
+    ruby-progressbar (1.13.0)
+    ruby2_keywords (0.0.5)
+    stringio (3.1.0)
+    thor (1.3.0)
+    timeout (0.4.1)
+    tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (2.2.0)
-    webrick (1.7.0)
-    websocket-driver (0.7.5)
+    unicode-display_width (2.5.0)
+    webrick (1.8.1)
+    websocket-driver (0.7.6)
       websocket-extensions (>= 0.1.0)
     websocket-extensions (0.1.5)
-    yard (0.9.28)
-      webrick (~> 1.7.0)
-    zeitwerk (2.6.0)
+    yard (0.9.34)
+    zeitwerk (2.6.13)
 
 PLATFORMS
   ruby
@@ -227,6 +268,7 @@ PLATFORMS
 
 DEPENDENCIES
   combustion
+  nokogiri (~> 1.15.5)
   pry-byebug
   rails (~> 7.0)
   rake (~> 13.0)
@@ -240,4 +282,4 @@ DEPENDENCIES
   yard
 
 BUNDLED WITH
-   2.3.9
+   2.4.22

data/Makefile

@@ -1,38 +1,64 @@
 SPEC =
 
 .PHONY: test
-test: rails60 rails61 rails70 rubocop
+test: test-stable rubocop
 
-.PHONY: rails60
-rails60:
+.PHONY: test-stable
+test-stable: rails-6.0 rails-6.1 rails-7.0 rails-7.1
+
+.PHONY: test-all
+test-all: test rails-main
+
+# TODO: make rails-* tasks DRY?
+
+.PHONY: rails-6.0
+rails-6.0:
+ifeq ($(SPEC),)
+	export BUNDLE_GEMFILE=gemfiles/rails-6.0/Gemfile && bundle --quiet && bundle exec rake spec
+else
+	export BUNDLE_GEMFILE=gemfiles/rails-6.0/Gemfile && bundle --quiet && bundle exec rspec $(SPEC)
+endif
+
+.PHONY: rails-6.1
+rails-6.1:
+ifeq ($(SPEC),)
+	export BUNDLE_GEMFILE=gemfiles/rails-6.1/Gemfile && bundle --quiet && bundle exec rake spec
+else
+	export BUNDLE_GEMFILE=gemfiles/rails-6.1/Gemfile && bundle --quiet && bundle exec rspec $(SPEC)
+endif
+
+.PHONY: rails-7.0
+rails-7.0:
 ifeq ($(SPEC),)
-	export BUNDLE_GEMFILE=gemfiles/rails-6.0 && bundle --quiet && bundle exec rake spec
+	export BUNDLE_GEMFILE=gemfiles/rails-7.0/Gemfile && bundle --quiet && bundle exec rake spec
 else
-	export BUNDLE_GEMFILE=gemfiles/rails-6.0 && bundle --quiet && bundle exec rspec $(SPEC)
+	export BUNDLE_GEMFILE=gemfiles/rails-7.0/Gemfile && bundle --quiet && bundle exec rspec $(SPEC)
 endif
 
-.PHONY: rails61
-rails61:
+.PHONY: rails-7.1
+rails-7.1:
 ifeq ($(SPEC),)
-	export BUNDLE_GEMFILE=gemfiles/rails-6.1 && bundle --quiet && bundle exec rake spec
+	export BUNDLE_GEMFILE=gemfiles/rails-7.1/Gemfile && bundle --quiet && bundle exec rake spec
 else
-	export BUNDLE_GEMFILE=gemfiles/rails-6.1 && bundle --quiet && bundle exec rspec $(SPEC)
+	export BUNDLE_GEMFILE=gemfiles/rails-7.1/Gemfile && bundle --quiet && bundle exec rspec $(SPEC)
 endif
 
-.PHONY: rails70
-rails70:
+.PHONY: rails-main
+rails-main:
 ifeq ($(SPEC),)
-	export BUNDLE_GEMFILE=gemfiles/rails-7.0 && bundle --quiet && bundle exec rake spec
+	export BUNDLE_GEMFILE=gemfiles/rails-main/Gemfile && bundle --quiet && bundle exec rake spec
 else
-	export BUNDLE_GEMFILE=gemfiles/rails-7.0 && bundle --quiet && bundle exec rspec $(SPEC)
+	export BUNDLE_GEMFILE=gemfiles/rails-main/Gemfile && bundle --quiet && bundle exec rspec $(SPEC)
 endif
 
 .PHONY: update
 update:
-	export BUNDLE_GEMFILE=gemfiles/rails-6.0 && bundle update
-	export BUNDLE_GEMFILE=gemfiles/rails-6.1 && bundle update
-	export BUNDLE_GEMFILE=gemfiles/rails-7.0 && bundle update
-	export BUNDLE_GEMFILE=Gemfile            && bundle update
+	export BUNDLE_GEMFILE=gemfiles/rails-6.0/Gemfile  && bundle update
+	export BUNDLE_GEMFILE=gemfiles/rails-6.1/Gemfile  && bundle update
+	export BUNDLE_GEMFILE=gemfiles/rails-7.0/Gemfile  && bundle update
+	export BUNDLE_GEMFILE=gemfiles/rails-7.1/Gemfile  && bundle update
+	export BUNDLE_GEMFILE=gemfiles/rails-main/Gemfile && bundle update
+	export BUNDLE_GEMFILE=Gemfile                     && bundle update
 
 .PHONY: rubocop
 rubocop:
@@ -52,4 +78,7 @@ texd-docker:
 		-v $$(pwd)/tmp/jobs:/texd \
 		-v $$(pwd)/tmp/refs:/refs \
 		-u $$(id -u):$$(id -g) \
-			digineode/texd --reference-store dir:///refs --keep-jobs always
+		ghcr.io/digineo/texd \
+			--reference-store dir:///refs \
+			--retention-policy=purge-on-start \
+			--keep-jobs always

data/README.md

@@ -10,15 +10,26 @@ in background jobs.
 
 You need to meet the following requirements for this gem to work:
 
-- Ruby 2.7 or later
+- Ruby 2.7 or later[^1]
 - Rails 6.0 or later
 
 Older versions of Ruby and Rails *may* work, but this is not guaranteed.
 
+(Please note that the current Rails `main` branch, i.e. Rails 7.2-to-be,
+requires Ruby 3.1+[^2].)
+
 Install the gem and add to the application's Gemfile by executing:
 
     $ bundle add texd
 
+[^1]: We're currently tracking the Ruby version shipped with
+  [Ubuntu Focal (20.04 LTS)](https://packages.ubuntu.com/focal/ruby).
+  This may jump to [Ubuntu Noble (24.04 LTS)](https://packages.ubuntu.com/noble/ruby)
+  and Ruby 3.1 in the near future.
+
+[^2]: See [commit `6ba2fdb`](https://github.com/rails/rails/commit/6ba2fdb2fe85751b573aadd05608471daf1a44ff)
+  and [PR #50491](https://github.com/rails/rails/pull/50491) in the Rails repository.
+
 ## Configuration
 
 Before you can use texd, you need to tell it where your instance is located.
@@ -215,8 +226,9 @@ push git commits and the created tag, and push the `.gem` file to
 [rubygems.org](https://rubygems.org).
 
 You may want to run a texd server instance locally. This is easiest done by
-calling either `make texd-server` (this requires Docker). If you need to
-develop/test against the bleeding edge, you can clone and run texd from source:
+calling `make texd-docker` (which pulls and runs the `ghcr.io/digineo/texd` Docker
+image). If you need to develop/test against the bleeding edge, you can clone and
+run texd from source:
 
 ```console
 $ cd ~/code/github.com/digineo
@@ -226,6 +238,10 @@ $ mkdir -p tmp/refs
 $ make run-container EXTRA_RUN_ARGS='--reference-store dir://./tmp/refs'
 ```
 
+Note: In order to run the tests against the latest `rails/main` commit, you
+need to have Ruby 3.1+ installed. To run the tests against all released Rails
+versions, Ruby 2.7 currently suffices.
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/digineo/texd.