From 76e3dd74ee16489ab5f749e7df3412331fad7d3b Mon Sep 17 00:00:00 2001
From: Koji Takao <koji.takao@speee.jp>
Date: Wed, 21 Jan 2026 13:23:12 +0900
Subject: [PATCH 1/2] Add Speee fork installation instructions to README

Document how to install the Speee fork via GitHub repository reference
with tag specification. This addresses the distribution method decision
made in issue #12.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 README.md | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 0a2e24ab..7d562541 100644
--- a/README.md
+++ b/README.md
@@ -24,9 +24,27 @@ which *should* be compatible with JSON:API compliant server implementations such
 
 ## Installation
 
-Add JR to your application's `Gemfile`:
+### Speee Fork
 
+This is the Speee fork of jsonapi-resources. To use this fork, add the following to your application's `Gemfile`:
+
+```ruby
+gem 'jsonapi-resources', github: 'speee/jsonapi-resources', tag: 'v26.1.1'
+```
+
+Then execute:
+
+```bash
+bundle install
 ```
+
+You can find available tags at [https://github.com/speee/jsonapi-resources/tags](https://github.com/speee/jsonapi-resources/tags).
+
+### Original (upstream)
+
+To use the original jsonapi-resources gem from RubyGems, add it to your application's `Gemfile`:
+
+```ruby
 gem 'jsonapi-resources'
 ```
 

From ec6006232fae6b4575226edb1cd0120e1e198063 Mon Sep 17 00:00:00 2001
From: Koji Takao <koji.takao@speee.jp>
Date: Wed, 21 Jan 2026 13:27:42 +0900
Subject: [PATCH 2/2] Add Speee fork goals and key changes to README

Document the purpose of this fork (modern Rails support and 0.9.x
backward compatibility) and summarize key changes from upstream
including Rails 7.1-8.1 support, backward compatibility features,
and bug fixes.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 README.md | 34 ++++++++++++++++++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 7d562541..e56aa415 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,36 @@ of your resources, including their attributes and relationships, to make your se
 JR is designed to work with Rails 5.1+, and provides custom routes, controllers, and serializers. JR's resources may be
 backed by ActiveRecord models or by custom objects.
 
+## Speee Fork
+
+This is the [Speee](https://speee.jp/) fork of [jsonapi-resources](https://github.com/cerebris/jsonapi-resources).
+
+### Goals
+
+- **Modern Rails Support**: Enable compatibility with the latest Rails versions (7.1, 7.2, 8.0, 8.1+)
+- **0.9.x Backward Compatibility**: Maintain compatibility with code written for jsonapi-resources 0.9.x
+
+### Key Changes from Upstream
+
+#### Rails Compatibility
+- Full support for Rails 7.1, 7.2, 8.0, and 8.1
+- Rack 3.0 compatibility fixes
+- Rails 8.2 deprecation warning fixes
+
+#### 0.9.x Backward Compatibility
+- `result.resource` and `result.resources` accessors on operation results
+- `apply_filters` method made public for custom filter implementations
+- PORO (Plain Old Ruby Object) support in `find_fragments`
+
+#### Bug Fixes
+- MySQL compatibility fix for the `quote` method (uses database adapter)
+- Ruby 2.6/2.7 compatibility for `Psych.unsafe_load`
+
+#### Development
+- Docker support for multi-version Rails testing
+- Comprehensive CI matrix covering Ruby 2.6-3.4 and Rails 5.1-8.1
+- SimpleCov integration for test coverage measurement
+
 ## Documentation
 
 Full documentation can be found at [http://jsonapi-resources.com](http://jsonapi-resources.com), including the [v0.10 alpha Guide](http://jsonapi-resources.com/v0.10/guide/) specific to this version.
@@ -24,9 +54,9 @@ which *should* be compatible with JSON:API compliant server implementations such
 
 ## Installation
 
-### Speee Fork
+### Using This Fork
 
-This is the Speee fork of jsonapi-resources. To use this fork, add the following to your application's `Gemfile`:
+To use this fork, add the following to your application's `Gemfile`:
 
 ```ruby
 gem 'jsonapi-resources', github: 'speee/jsonapi-resources', tag: 'v26.1.1'