Skip to content

Document Kafka partitioners, analyzers, and code fixes - #2

Open
lillo42 wants to merge 3 commits into
masterfrom
docs/kafka-partitioner
Open

Document Kafka partitioners, analyzers, and code fixes#2
lillo42 wants to merge 3 commits into
masterfrom
docs/kafka-partitioner

Conversation

@lillo42

@lillo42 lillo42 commented Jul 24, 2026

Copy link
Copy Markdown
Owner

Description

Documents the Kafka partitioner guidance and the new Roslyn analyzer/code-fix support from BrighterCommand/Brighter#4255.

Changes

  • Expands the Kafka configuration page with hash partitioning guidance and the Murmur2Random recommendation.
  • Adds a new Analyzer Support page covering:
    • Analyzer package installation.
    • The BRT001–BRT008 diagnostic reference.
    • Kafka partitioner diagnostics BRT006–BRT008.
    • Quick Action and Fix All code-fix behavior.
    • Guidance for preserving existing topic key mappings.
    • Narrow warning-suppression examples.
  • Adds the analyzer page to SUMMARY.md for GitBook navigation.

Related

Notes

The docs recommend Partitioner.Murmur2Random for new publications and call out that changing the partitioner on an existing topic can change key-to-partition mapping.

lillo42 added 3 commits July 23, 2026 21:34
…2Random

- Document all Partitioner enum values (Random, Consistent, ConsistentRandom,
  Murmur2, Murmur2Random) and the differences between them
- Recommend Partitioner.Murmur2Random for Java producer compatibility and
  better key distribution
- Update the Partitioner publication property to link to the new section
…tion

Drop the Java compatibility rationale; frame the recommendation around
even key distribution vs. hot partitions, and the problems uneven
distribution causes (consumer bottlenecks, capped throughput, lag).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant