[KAFKA-17671] Create better documentation for transactions

• Type: Task
• Status: Patch Available
• Priority: Major
• Resolution: Unresolved
• Assignee: Andrew Schofield
• Reporter: Justine Olshan
• Created: 30/Sep/24 20:14
• Updated: 23/Oct/24 23:58

Description

There is not a single source of truth that explains how transactions should work in kafka.

We should create a document that explains how they work, the guarantees, and tips for how to design applications that use transactions.

 

The topic came up when discussing https://issues.apache.org/jira/browse/KAFKA-17582 and the expectations for consumer offsets when transactions are aborted. This should be made clear in the documentation.

Issue Links

• links to: GitHub Pull Request #17454