DOC-6832 Add go-redis automatic pipelining page [PARKED]

[andy-stark-redis]

Adds a new Automatic pipelining page to the go-redis client docs, covering the
experimental AutoPipeline() / AsyncAutoPipeline() APIs (blocking and async faces),
config options, cluster slot sharding, and caveats, based on go-redis PR #3867.

⛔️ Do not merge yet. These docs are written against an unmerged, draft upstream PR
(redis/go-redis#3867). The API is
experimental and still actively changing (a public-API refactor landed on the draft
after the docs were first written — see the manifest). No released go-redis version ships
it, the version note on the page is a placeholder (v9.XX.0), and the examples are static
code blocks rather than tested clients-example doctests. Pick this up once the feature
merges to master and ships in a release.

Park manifest

Ticket: DOC-6832
Parked at: 2026-07-10 (re-parked 2026-07-13 with refreshed snapshot)
Trigger to pick up: AutoPipeline() / AsyncAutoPipeline() merged to go-redis master and shipped in a released go-redis v9 version (PR #3867 currently targets the feature/autopipeline/integration branch, not master).
Labels: parked, do not merge yet

Pinned sources (state observed at park time)

Source	State at last snapshot (2026-07-13)	Re-fetch
redis/go-redis#3867 — "feat(autopipeline): #3 wire into Client and ClusterClient"	state: open · draft: true · merged: false · base: feature/autopipeline/integration · milestone: autopipeline (no version) · head SHA: 4fa15e5ce484eb704b6ee114771dbf432e7b97a8 · updated: 2026-07-13T07:45:24Z	gh api repos/redis/go-redis/pulls/3867 --jq '{state, merged, draft, head_sha: .head.sha, base: .base.ref, milestone: .milestone.title, updated_at}'

Snapshot history: first parked at head 4bb2c98 (2026-07-10); re-parked at head 4fa15e5
(2026-07-13) after a /pickup found the trigger unmet and the diff moved by +2 commits. To
diff future churn from this snapshot: gh api repos/redis/go-redis/compare/4fa15e5ce484eb704b6ee114771dbf432e7b97a8...<new-head>.

PR #3867 is PR 3 of a series and, per its description, depends on an engine PR ("#1") and an
optional pipeline-pool PR ("#2"); those numbers are the author's in-series shorthand, not
verified GitHub PR numbers, so they are not snapshotted here. Resolve the real dependency PRs
on pickup.

Observed shape — confidence: LOW (unmerged draft, API confirmed still churning)

The page as committed currently documents the original draft shape:

• AutoPipeline(nil) / AsyncAutoPipeline(nil) taking an optional *AutoPipelineConfig, returning (*AutoPipeliner, error).
• Config type AutoPipelineConfig with fields MaxBatchSize, MaxFlushDelay, MaxConcurrentBatches (>1 requires Unordered), NumShards, PipelinePoolSize, Unordered, MaxRetries.
• Blocking vs async faces; cached/first-config-wins/Close; cluster slot sharding; caveats (context not honored once queued, blocking commands never batched, Do bypasses batching, whole-batch retry double-executes).

⚠️ Known divergence observed at re-park (head 4fa15e5, commit "refactor(autopipeline): AutoPipelineOptions + no-arg / WithOptions methods") — the page is already behind:

• Config type renamed AutoPipelineConfig → AutoPipelineOptions (settable via Options.AutoPipelineOptions); DefaultAutoPipelineConfig() → DefaultAutoPipelineOptions(), plus a distinct DefaultBlockingAutoPipelineOptions().
• Method shape split: no-arg AutoPipeline() / AsyncAutoPipeline() (use Options/built-in default) plus AutoPipelineWithOptions(*AutoPipelineOptions) / AsyncAutoPipelineWithOptions(...). The old AutoPipeline(nil) form is gone.
• New config field AdaptiveDelay (requires MaxFlushDelay > 0) — not on the page.
• Defaults now visible: MaxBatchSize 200 (default/async) / 300 (blocking); MaxConcurrentBatches 1 (ordered).
• Extra validation rule: NumShards > 1 requires Unordered: true on the async (deferred) face.
• ring.go and sentinel.go were also touched — Ring / failover clients may now expose autopipelining beyond Client / ClusterClient. Unverified; check at pickup.

All of the above is from a still-draft diff and may move again before release — do not edit the page against it now.

Re-check checklist

• (high risk) Rename AutoPipelineConfig → AutoPipelineOptions throughout the page (type, DefaultAutoPipelineOptions()), if the rename survives to release.
• (high risk) Update method usage: no-arg AutoPipeline() / AsyncAutoPipeline() and the WithOptions variants; drop the AutoPipeline(nil) form. Show config via Options.AutoPipelineOptions and/or AutoPipelineWithOptions(...).
• (high risk) Confirm the version note — replace the v9.XX.0 placeholder with the real go-redis version that ships the API.
• (high risk) Convert the static ```go blocks to tested {{< clients-example >}} doctests once a go-redis release ships the API and an example set exists.
• Add the AdaptiveDelay config field (requires MaxFlushDelay > 0) and the observed defaults (MaxBatchSize 200/300, MaxConcurrentBatches 1) if they hold at release.
• Add the NumShards > 1 → Unordered (async face) validation rule.
• Check whether Ring / failover (SentinelClient) clients expose autopipelining and document/scope accordingly.
• Verify cluster slot-sharding behaviour and per-key ordering description against the merged code.
• Confirm the caveats list (context, blocking commands, Do, whole-batch retry) still holds.
• Decide whether to keep or drop the bannerText / {{< note >}} "experimental" wording depending on the feature's status at release.
• Resolve and (if useful) link the real dependency PRs behind the in-series "Update to gitignore #1"/"Lrc 95 #2" references.

On pickup, then

When the trigger fires, run /pickup on this PR. It reconciles the docs against the
now-settled source and takes the PR through the normal /reflect → /finalize pipeline to
merge. The do not merge yet guard holds until /finalize completes.

🤖 Generated with Claude Code

[github-actions]

DOC-6832

[github-actions]

Staging links:
https://redis.io/docs/staging/DOC-6832-document-go-redis-automatic-pipelining-pr-3867/develop/clients/go/autopipeline/
https://redis.io/docs/staging/DOC-6832-document-go-redis-automatic-pipelining-pr-3867/develop/clients/go/transpipe/