diff --git a/developer-tools/sdks/index.mdx b/developer-tools/sdks/index.mdx index 4969016..b1a1327 100644 --- a/developer-tools/sdks/index.mdx +++ b/developer-tools/sdks/index.mdx @@ -52,7 +52,7 @@ TypeScript, Python, Go, PHP, Ruby, and Rust clients also accept [REST OAuth toke | Python | See the language guide | `qubrics-sending`, `qubrics-mailbox`, `qubrics-management` | | Go | `sendmux.ai/go/v3` | `sending`, `mailbox`, `management`, and `sdk` subpackages | | PHP | `qubrics/sdk` | `qubrics/sending`, `qubrics/mailbox`, `qubrics/management` | -| Ruby | See the language guide | `qubrics-sending`, `qubrics-mailbox`, `qubrics-management` | +| Ruby | `qubrics-sdk` | `qubrics-sending`, `qubrics-mailbox`, `qubrics-management` | | Rust | `sendmux` | `sending`, `mailbox`, and `management` modules inside the `sendmux` crate | The Python and Ruby guides list the published surface versions and their matching imports. Check [package names and imports](/developer-tools/sdks/versioning-support#package-names-and-imports) before upgrading an existing installation. diff --git a/developer-tools/sdks/ruby.mdx b/developer-tools/sdks/ruby.mdx index 04f4530..dde77e6 100644 --- a/developer-tools/sdks/ruby.mdx +++ b/developer-tools/sdks/ruby.mdx @@ -27,6 +27,12 @@ Use the Ruby SDK when your application needs gems for the Sending, Mailbox, or M ## Install +Install `qubrics-sdk` 3.0.0 for all three API surfaces, or choose separate surface gems: + +```bash +gem install qubrics-sdk --version 3.0.0 +``` + Install a gem for each surface you use. These examples use `qubrics-sending` 2.0.0, `qubrics-mailbox` 3.0.0 and `qubrics-management` 3.0.0. @@ -65,6 +71,8 @@ The provider runs before each request. Your application owns secure token storag Require the surface gem you installed, then create its client. +If you installed the umbrella gem, use `require 'qubrics/sdk'` to load all three surface clients. + ```ruby Sending diff --git a/developer-tools/sdks/versioning-support.mdx b/developer-tools/sdks/versioning-support.mdx index 2ba1ad4..741fd25 100644 --- a/developer-tools/sdks/versioning-support.mdx +++ b/developer-tools/sdks/versioning-support.mdx @@ -38,9 +38,14 @@ Keep the package version and import path together. Installing an old-name distri | PyPI | `sendmux-management` | `3.0.0` | `qubrics.management` | | RubyGems | `qubrics-core` | `2.0.0` | `qubrics/core` | | RubyGems | `sendmux-core` | `2.0.0` | `qubrics/core` | +| RubyGems | `qubrics-sdk` | `3.0.0` | `qubrics/sdk` | +| RubyGems | `sendmux-sdk` | `3.0.0` | `qubrics/sdk` | | RubyGems | `qubrics-sending` | `2.0.0` | `qubrics/sending` | +| RubyGems | `sendmux-sending` | `2.0.0` | `qubrics/sending` | | RubyGems | `qubrics-mailbox` | `3.0.0` | `qubrics/mailbox` | +| RubyGems | `sendmux-mailbox` | `3.0.0` | `qubrics/mailbox` | | RubyGems | `qubrics-management` | `3.0.0` | `qubrics/management` | +| RubyGems | `sendmux-management` | `3.0.0` | `qubrics/management` | Use the language guides for client examples. Each release covers one package. Check the version and namespace for every language, umbrella package or related developer tool you use. diff --git a/evidence/rebrand-qubrics-docs75-ruby-final-20261120.md b/evidence/rebrand-qubrics-docs75-ruby-final-20261120.md new file mode 100644 index 0000000..fc96aaf --- /dev/null +++ b/evidence/rebrand-qubrics-docs75-ruby-final-20261120.md @@ -0,0 +1,66 @@ +# Ruby umbrella and final pointer facts + +Scope: docs#75 Ruby-dependent facts, based on origin/main `5061e6b`. +Three existing pages change; navigation, Rust, authentication, compatibility +identifiers, API contracts and changelog remain unchanged. Publication requires +its own Ops approval; rollback is revert the resulting merge and republish. + +## Owning publication evidence + +SDK MAIN `.claude/tasks/rebrand-qubrics-sdk344/`: + +- `ruby-sdk-public-20261120.md`: public `qubrics-sdk` 3.0.0, SHA256 + `622b6aeacb5b069a6c2f3fc7bc02763b17a9478b0a2b2e0e6233a65e29e4dd91`, + fresh isolated public install and `require 'qubrics/sdk'` pass. +- `ruby-sdk-pointer-public-20261120.md`: public `sendmux-sdk` 3.0.0, SHA256 + `134b8ceeb81432af44f3e11c31ca74550da30369b191c9530ee826df28b134a7`, + unyanked, fresh isolated install resolves all five native Qubrics gems. +- `ruby-sending-pointer-public-20261120.md`, + `ruby-mailbox-pointer-public-20261120.md`, + `ruby-management-pointer-public-20261119.md` and the linked Core/surface + receipts qualify the complete ten-row RubyGems table. Dependency-only + pointers provide no old import path. No deprecation-message claim added. + +Canonical: spec A18 requires Qubrics packages/modules; A17 compatibility +identifiers remain accepted. Install commands and require paths come from +the public consumer receipts, without a repeated package install or upload. + +## Content and placement + +Guides > Developer tools > SDKs > Ruby, overview, and versioning/support. +Keep existing pages/order. Add the umbrella install/require, identify it in +the overview, and complete all ten released RubyGems rows. The published +surface examples/defaults from PR91 remain intact. + +Fresh copy critique found one ambiguous umbrella/surface sequence. Explicit +alternative wording resolves it; all applicable polish rubric lines pass. +Humanize ran once on the new instruction sentences: zero em dashes, +semicolons, curly quotes, banned terms or contrastive framing; under 80 words. +Protected package/version/import tokens, existing auth constraints, headings, +links and page structure remain exact. No rename announcement added. + +## Verification + +- `git diff --check`, `npm run confidentiality:check`, and + `npm run external-links:check`: exit 0. +- `mint broken-links`: exit 0, no broken links. +- `mint validate`: exit 0, build and validation passed on final copy. +- Real Chrome preview at port 61076: all three pages rendered; overview and + compatibility GETs 200, Ruby GET 200. At 04:54:57Z, assertions confirmed + the exact umbrella install command, require and alternative wording, + the overview Ruby umbrella row, and all ten package/version/require rows. + No console errors; local-preview Socket.io connection warning only. +- No new tests: static documentation facts; existing full tooling suite runs + in CI. No old source-text tests or assertions weakened. +- Standards review: zero hard or heuristic findings. Spec review: zero findings; + all ten exact-version registry records and the downloaded umbrella payload + agree with the release receipts and instructions. + +Raw validation and preview logs: docs MAIN +`.claude/artifacts/rebrand-qubrics-docs75/ruby-final-*-20261120.log`. +Preview/browser stopped after verification; exact owned cache removed. +Read-only T-47269 check 04:52:35Z returned 200 with the same handled reply ID; +no provider changes, Re-verify or support message. + +Status: branch only; CI, merge and publication pending. Rust remains +unpublished and untouched; no whole-goal completion claimed.