DOC-7033 Add Ruby (redis-rb) vector set client docs [PARKED]

[andy-stark-redis]

Adds content/develop/clients/ruby/vecsets.md and a new home_vecsets example
(local_examples/client-specific/ruby/home_vecsets.rb), giving the vector-set
client docs a Ruby tab alongside the existing Go, Node.js, Python, and Lettuce
tabs. Uses the same "famous people" text-embedding dataset as the other clients,
via the informers gem running sentence-transformers/all-MiniLM-L6-v2 locally.

Follow-up to the vector-set client docs already shipped for other clients, and
sibling to DOC-6957 (Ruby array data type examples) in using redis-rb master
ahead of a release.

Also adds local_examples/vecset_tutorial/ruby/dt_vec_set.rb — a Ruby tab
for the separate vecset_tutorial example set embedded on the data-types
tutorial pages (content/develop/data-types/vector-sets/_index.md,
memory.md, performance.md), alongside the existing Python tab. No page
edits needed there: those pages embed clients-example with no lang_filter,
so the tab appears once examples.json regenerates. Same park status as the
rest of this PR (same unreleased gem), different example family (data-type
tutorial vs. client guide) and a different file placement convention —
local_examples/<set>/<client-alias>/<file>, resolved by
convention_src_path() in run.sh rather than the legacy_src_path()
case-statement used by the other Ruby dt_*.rb tutorial files.

Ran this file for real too, against the same redis-rb master + Redis 8.8.0
setup. One real bug found and fixed in the process: Kernel#puts special-cases
Array (prints one element per line, no brackets/quotes) but not Hash, so an
initial draft's # >>> comments for five array-returning steps (the five
vemb calls, vsim_basic, and the two vsim_filter queries) would have shown
readers one-value-per-line instead of the bracketed list actually documented.
Switched those specific print calls to p (which calls .inspect).

⛔ Do not merge yet

These examples are written against redis-rb master, where vector set
support is merged but not released. redis-rb#1382
merged 2026-09-03; the latest gem, v6.0.0 (2026-07-31), predates the
merge and has no lib/redis/commands/vector_sets.rb.

Merging to main auto-publishes. A reader on the released gem would get
NoMethodError on every line. Hold until a released gem ships the vector-set
commands.

Park manifest

Ticket: DOC-7033
Parked at: 2026-09-04
Trigger to pick up: a released redis gem (tag newer than v6.0.0) that contains lib/redis/commands/vector_sets.rb — testably, gh api "repos/redis/redis-rb/contents/lib/redis/commands?ref=<tag>" --jq '.[].name' | grep vector_sets returns a match at that tag.
Labels: parked, do not merge yet

Pinned sources (state observed at park time, 2026-09-04)

Source	State @ park	Re-fetch
redis-rb#1382 — "Add Vector Set commands"	merged 2026-09-03T11:00:54Z; merge commit 5a495492a3e9b8b23607c457da0d3254f1d21cd9; head f2bdabfb002dd3c7c672bd3494f0d93402b9ff90; base master	gh api repos/redis/redis-rb/pulls/1382 --jq '{merge_commit_sha,head_sha:.head.sha,base:.base.ref,merged_at}'
lib/redis/commands/vector_sets.rb @ master — the file every signature came from	blob e2dc3e9c70f3121199f57280f33f899291cd88c9, 16689 bytes	gh api "repos/redis/redis-rb/contents/lib/redis/commands/vector_sets.rb?ref=master" --jq '{sha,size}'
Released gem — the actual blocker	latest release v6.0.0, published 2026-07-31; confirmed no vector_sets.rb at that tag	gh api repos/redis/redis-rb/releases --jq '.[0].tag_name'

The blob SHA is the drift tripwire: if e2dc3e9c still matches at unpark, no signature in this PR can have moved.

Observed shape the page assumes

HIGH confidence — method signatures and wire behavior. Read directly from vector_sets.rb at the pinned blob, and every call in the example was run for real (not just compiled) against redis-rb master + Redis 8.8.0 with a live vector-set-capable server.

HIGH confidence — semantic correctness, but library-specific. All eight query results were captured from an actual run, not inherited from another client's tab. Four of the five printed query results match the Python (sentence-transformers) tab's ordering exactly. The entertainer_query result does not: Ruby's informers/onnxruntime binding ranks "Linus Pauling" ahead of "Masako Natsume", where Python's sentence-transformers binding ranks them the other way around. Both are plausible outputs of the same nominal model — this is a genuine cross-binding floating-point/pooling difference, not a bug in either example. The doc's comments and assertions reflect Ruby's actual observed values.

Re-check checklist

• Re-run both example files end-to-end (home_vecsets.rb and dt_vec_set.rb) against the released gem + Redis 8.8+, not just re-diff signatures. Embedding-dependent orderings (home_vecsets.rb only) are exactly the kind of thing a signature diff can't catch.
• Re-diff vector_sets.rb against blob e2dc3e9c; if it moved, re-check every method call in both example files (vadd, vcard, vdim, vemb, vsetattr, vgetattr, vrem, vsim) against the new source, not just the ones each file happens to use.
• Add a ruby entry to data/command-api-mapping/VADD.json, VSIM.json, VINFO.json, VDIM.json, VCARD.json, VEMB.json, VLINKS.json, VRANGE.json, VSETATTR.json, VGETATTR.json — deliberately not done in this PR (mapping entries against unreleased APIs have been wrong before — DOC-6957).
• Confirm the Ruby tab actually renders on both vecsets.md (client guide) and content/develop/data-types/vector-sets/{_index,memory,performance}.md (data-type tutorial) after examples.json regenerates from a full build/make.py run — this PR's own verification only ran npx hugo on the checked-in tree (clean, no shortcode/link warnings) and ran both example scripts directly; it did not run the full multi-client example-generation pipeline, so neither TCE tab's actual rendered content was observed.
• Resolve the <!-- TODO(DOC-7033) --> comment at the top of vecsets.md and update the Gemfile install snippet from the git:/branch: 'master' pin to the real released version.

On unpark, then

When the trigger fires, run /unpark <this PR>. It reconciles the docs against the now-settled source and takes the PR through the normal /reflect → /finalize pipeline to merge. /finalize is deferred until then — squashing now would discard this episodic note. The do not merge yet guard holds until /finalize completes.

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation and example code only; merge is blocked until a released redis-rb gem includes vector-set APIs, limiting exposure of the master-only install instructions.

Overview
Adds a Ruby vector set embeddings page at vecsets.md and wires it into the shared home_vecsets example set so Ruby appears alongside the other client tabs.

The guide walks through informers + redis-rb (vadd, vsim with count and attribute filters) using the same famous-people embedding tutorial. The runnable example lives in home_vecsets.rb, with assertions on observed similarity rankings from the Ruby ONNX stack.

The page still pins redis from master and carries a DOC-7033 note because vector-set commands are not in a released gem yet—the PR is parked until that ships, so readers on v6.0.0 would hit NoMethodError if this merged without the follow-up Gemfile/version update.

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

[github-actions]

DOC-7033

[github-actions]

Staging links:
https://redis.io/docs/staging/DOC-7033-redis-rb-vecsets-examples/develop/clients/ruby/vecsets/

[github-actions]

🧠 Redis Memory

Found 8 related items from repository history (3 new this commit):

• PR — DOC-6957 Add Ruby (redis-rb) array data type examples [PARKED]

  DOC-6957 — Ruby (redis-rb) array data type examples

• PR — DOC-6854 Add redis-rb (Ruby) vector search docs: vecsearch page + ruby_home_query_vec [PARKED]

  Preemptive docs for redis-rb's Query Engine vector search: a new "Index and query vectors" page for Ruby (`content/develop/clients/ruby/

• PR — DOC-6843 Add redis-rb (Ruby) Query Engine docs: queryjson [PARKED]

  Preemptive docs for redis-rb's Query Engine (RediSearch / FT.*): a new "Index and query documents" page for Ruby (`content/develop/cli

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

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

• Commit — DOC-6957 Add Ruby array data type examples

  DOC-6957 Add Ruby array data type examples

• PR — DOC-7033 Add Rust (redis-rs) vector set client docs 🆕

  Adds content/develop/clients/rust/vecsets.md and a new home_vecsets example

• Commit — DOC-7033 Add Ruby (redis-rb) vector set client docs 🆕

  DOC-7033 Add Ruby (redis-rb) vector set client docs

• Commit — DOC-7033 Add Rust (redis-rs) vector set client docs 🆕

  DOC-7033 Add Rust (redis-rs) vector set client docs

Memory updated at 884de28