DOC-6842 Add redis-rb (Ruby) JSON docs [PARKED]

[andy-stark-redis]

DOC-6842 — redis-rb (Ruby) JSON docs

Adds Ruby (redis-rb) coverage for the JSON data type, in two parts:

• Example: a Ruby port of the json_tutorial doctest set (local_examples/tmp/datatypes/json/dt_json.rb, all 18 steps) using redis-rb's json_* methods. The Ruby tab on the JSON data-type page is generated from this .rb source at build time (data/examples.json is git-ignored, so it is intentionally not in this diff).
• Command mappings: redis_rb method signatures added to the 22 JSON.* command-api-mapping files, with descriptions taken from redis-rb's YARD docs.

Foundation for the follow-up redis-rb Query Engine docs (redis-rb#1356), which index JSON documents and build on this.

Warning

Do not merge yet — parked. These docs are written against redis-rb's JSON module, which is merged to master but not in any released gem (latest is v5.4.1, July 2025, which predates the module). Merge only after the trigger below fires. See redis-rb#1346–#1349.

Park manifest

Ticket: DOC-6842
Parked at: 2026-07-14
Trigger to pick up: a redis-rb gem is released (a tag/version later than v5.4.1) that includes lib/redis/commands/modules/json.rb
Labels: parked, do not merge yet

Pinned sources (state observed at park time)

Source	State at park time	Re-fetch
redis-rb gem releases	Latest tag v5.4.1, dated 2025-07-17 — predates the JSON module. No release yet contains JSON.	gh api repos/redis/redis-rb/tags --jq '.[0:5][].name' then confirm gh api "repos/redis/redis-rb/contents/lib/redis/commands/modules/json.rb?ref=<tag>" returns 200
redis-rb JSON module (json.rb on master)	Present; last commit fa90f44, 2026-06-11. Merged via PRs #1346–#1349.	gh api "repos/redis/redis-rb/commits?path=lib/redis/commands/modules/json.rb&per_page=1" --jq '.[0].sha'
redis-rb#1356 (Query Engine — follow-up dependency, not this PR)	Merged 2026-07-14 (head 659d885); now also master-only/unreleased.	gh api repos/redis/redis-rb/pulls/1356 --jq '{merged,head_sha}'

Observed shape the page assumes — confidence: HIGH (unusual for a parked PR)

The example and mappings were run-verified against the pinned source, not written blind against a diff: dt_json.rb executed against the redis-rb fork at master (json.rb fa90f44) on Redis 8.8 (ReJSON), exit 0, all 18 assert_equal blocks passing. Mapping signatures/types/descriptions were read from the same json.rb YARD source. Residual risk is only API drift between master and the eventual release — return shapes like json_set → "OK", json_arrpop parsed values, and the Array<…> vs scalar JSONPath/legacy-path distinction are the things to re-confirm if the API moves before the gem ships.

Re-check checklist (on pickup)

• (highest risk) Re-run local_examples/tmp/datatypes/json/dt_json.rb against the released gem — all 18 asserts must still pass.
• Diff the released json.rb against master@fa90f44 for signature/return-shape changes to any json_* method.
• If any signature changed, update the matching data/command-api-mapping/JSON.*.json file and re-run build/merge-command-api-mapping.sh (never hand-edit the merged data/command-api-mapping.json).
• Confirm the Ruby tab renders on the JSON data-type page once data/examples.json regenerates (it is generated from the .rb source; not in this diff).
• No data/examples.json entry was hand-added (it is git-ignored/generated) — verify none crept in.

On pickup, then

When the trigger fires, run /pickup 6842: it reconciles the docs against the now-released gem and takes the PR through the normal /reflect → /finalize pipeline to merge. /finalize is deferred until then — the episodic Recheck:/Gaps: commit trailers must survive for pickup. The do not merge yet guard holds until /finalize completes.

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation and reference JSON only; no runtime or auth changes. Residual risk is docs drifting from the eventual redis-rb gem release until pickup re-verification.

Overview
Adds Ruby (redis-rb) coverage for the JSON data type: a new json_tutorial doctest source and redis_rb entries on the existing JSON command reference data.

local_examples/tmp/datatypes/json/dt_json.rb is a Ruby port of the shared JSON tutorial (18 stepped sections). It exercises redis-rb’s json_* helpers—set/get, strings, numbers, arrays, objects, path queries, filters, and bulk updates—and documents the raw: option for pre-encoded JSON on several calls. Build output feeds the JSON data-type page Ruby tab (via generated examples.json, not in this diff).

data/command-api-mapping/JSON.*.json (22 commands) and the merged data/command-api-mapping.json each gain a redis_rb block: method signatures, parameters, and return descriptions aligned with redis-rb’s YARD docs (including JSONPath vs legacy path return shapes and optional raw).

PR is parked until a redis-rb release ships the JSON module (post–v5.4.1); docs target unreleased master API.

^{Reviewed by Cursor Bugbot for commit a42f75e. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

DOC-6842

[vladvildanov]

I think it also makes sense to add an examples with raw: true option. We allow to pass a raw JSON strings as an arguments or return raw JSON as a response to skip object mapping step in case data stored as plain JSON.

https://github.com/redis/redis-rb/blob/master/test/lint/json.rb#L15