aliehsaeedii opened a new pull request, #22776: URL: https://github.com/apache/kafka/pull/22776
Documents the streams group topology description plugin ([KIP-1331](https://cwiki.apache.org/confluence/display/KAFKA/KIP-1331%3A+Streams+Group+Topology+Description+Plugin)); docs subtask of KAFKA-20618. ### Changes - **New page** `docs/streams/developer-guide/topology-description-plugin.md`: feature overview, the push/describe cycle (heartbeat solicitation via `TopologyDescriptionRequired`, the `StreamsGroupTopologyDescriptionUpdate` RPC, permanent vs. transient plugin failures and the per-group back-off, describe via `StreamsGroupDescribe` v1), broker and client configuration, plugin implementation guidelines, Admin API and CLI usage, `TopologyDescriptionStatus` interpretation, `GROUP_DELETION_FAILED` semantics, and troubleshooting. - `config-streams.md`: add `topology.description.push.enabled` to the config table and the detailed entries. - `kafka-streams-group-sh.md`: document `--topology` output format, broker requirements (4.4+, plugin configured), and the tool's error messages / exit-code behavior. - `streams-rebalance-protocol.md`: list the feature as supported, add `group.streams.topology.description.plugin.class` to the broker-config list, and link the new page from the administration section. - `getting-started/upgrade.md`: notable-changes entry for 4.4.0 covering the new RPC, the `StreamsGroupDescribe`/`StreamsGroupHeartbeat` v1 bumps, `DeleteGroups` v3 with per-group `ErrorMessage`, the new error codes `GROUP_DELETION_FAILED` (134) and `STREAMS_TOPOLOGY_DESCRIPTION_UPDATE_FAILED` (135), and the new broker/client configs. - `streams/upgrade-guide.md`: 4.4.0 entry from the application perspective. - `operations/basic-kafka-operations.md`: point streams-group management at `kafka-streams-groups.sh`, including `--topology`. - `scala-migration.md`: weight bump only (16 → 17) to make room for the new page in the developer-guide ordering. All described behavior was verified against the implementation (`StreamsGroupTopologyDescriptionPlugin` SPI, `StreamsGroupTopologyDescriptionManager`, `StreamsGroupCommand`, the message JSON schemas, and the config definitions). ### Committer Checklist (excluded from commit message) - [ ] Verify design and implementation - [ ] Verify test coverage and CI build status - [ ] Verify documentation (including upgrade notes) 🤖 Generated with [Claude Code](https://claude.com/claude-code) -- 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: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
