Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Better descriptions? #137

Open
tombentley opened this issue Oct 30, 2023 · 0 comments
Open

Better descriptions? #137

tombentley opened this issue Oct 30, 2023 · 0 comments
Assignees
Labels

Comments

@tombentley
Copy link
Contributor

I'd like to suggest some alternative descriptions for the key fields the the topic creation wizard:

  • "Unique name used to recognize your topic. The topic name is also used by your producers and consumers as part of the connection information, so make it something easy to recognize."
    • → "The name used to identify your topic. This cannot be changed after creation. Consider grouping related topics by using a common prefix."
  • "An ordered list of messages. One or more partitions make up a topic. Partitions are distributed across the brokers to increase the scalability of your topic. You can also use them to distribute messages across the members of the consumer group."
    • → "A topic is composed of 1 or more partitions, which are each an ordered sequence of messages. Partitions enable scalability by distributing load across brokers and consumers. The number of partitions cannot be decreased after topic creation."
  • "How many copies of a topic will be made for high availability. The partitions of each topic can be replicated across a configurable number of brokers."
    • → "The messages in a partition are physically stored as a replica on a broker. Multiple replicas enable high availability by ensuring copies of the data are available."
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

2 participants