You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pulsar.apache.org by "merlimat (via GitHub)" <gi...@apache.org> on 2026/10/01 15:36:18 UTC

[PR] [doc][spec] PIP-494: Scalable Topics client specification [pulsar]

merlimat opened a new pull request, #26805:
URL: https://github.com/apache/pulsar/pull/26805

   ### Motivation
   
   [PIP-494](https://github.com/apache/pulsar/pull/26447) (approved) establishes `spec/scalable-topics/` as the
   authoritative, language-neutral specification of the Scalable Topics client: the client API, its semantics,
   and the protocol-level interactions. It is the required base for any new client SDK adding scalable-topics
   support and the reference for conformance. Today the only complete description of that behavior is the Java
   V5 client's source, with rationale spread across PIP-460 and its sub-PIPs (468/483/486).
   
   This PR delivers the specification that PIP-494 references.
   
   ### Modifications
   
   Add `spec/scalable-topics/` (index: `README.md`):
   
   - **Conventions** and **Terminology** — scope, BCP 14 normative language, naming policy, glossary.
   - **Stability and Versioning** — spec versioning, stability tiers, compatibility guarantees.
   - **Data Model** — topic identity, hash ring, message, message id, checkpoint, schema.
   - **Client API** — the observable contract: producers, the three consumer modes, transactions.
   - **Implementation Requirements** — routing, layout tracking, per-segment fan-out, retries, multiplexing,
     concurrency, resource lifetime.
   - **Wire Protocol** — the binary-protocol binding with sequence diagrams (DAG watch, consumer assignment,
     produce/consume, namespace watch, transaction-coordinator discovery, auto-creation, clean consumer leave).
   - **Error Model**, **Conformance** checklist, **Compatibility** with classic (v4) topics.
   - **Scalable Key-Shared Consumption** — entry-bucketing (PIP-486), aligned with the broker-side handoff design.
   - **Java Reference Mapping** — language-neutral operations/types to the Java V5 client surface.
   
   ### Verifying this change
   
   Documentation only; no code changes.
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@pulsar.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] [doc][spec] PIP-494: Scalable Topics client specification [pulsar]

Posted by "merlimat (via GitHub)" <gi...@apache.org>.
merlimat merged PR #26805:
URL: https://github.com/apache/pulsar/pull/26805


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@pulsar.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org