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

[DOC] some possible language errors and example errors in the v5.0 version document #580

Open
Koado opened this issue Jul 14, 2023 · 1 comment

Comments

@Koado
Copy link
Contributor

Koado commented Jul 14, 2023

Language Errors

  1. Domain Model > Topic > Behavior constraints:
    image
    image
    advised to change these sentences to:
    1.1 Consistent message types. The messages that...
    1.2 Only one type of messages sent to a topic. The messages that...
    1.3 消息类型必须一致:发送的消息的类型必须和目标主题定义的消息类型一致。。。
    1.4 主题类型必须单一:每个主题只支持一种消息类型,不允许将多种类型的消息发送到同一个主题中。。。

  2. 功能特性 > 消息发送重试和流控机制 > 背景信息:
    image
    There is an extra space between the letters M and Q.

  3. Feature Behavior > Message Filtering > Attribute-based SQL filtering:
    image
    image
    Use '/' instead of ''.

  4. Feature Behavior > Consumer Load Balancing > Message-based load balancing:
    image
    image
    advised to change these sentences to:
    4.1 More balanced consumption allocation. In conventional queue-based load...
    4.2 More forgiving to differences in networking capacities. In an online production...
    4.3 Easier O&M for queue allocation. In scenarios where conventional...
    4.4 消费分摊更均衡:对于传统队列级的负载均衡策略,如果。。。
    4.5 对非对等消费者更友好:在线上生产环境中,由于。。。
    4.6 队列分配运维更方便:传统基于绑定队列的负载均衡策略必须保证。。。

  5. 领域模型 > 队列 > 使用建议:
    image
    空轮询一词容易产生误解,空轮询多指Java NIO在Linux环境下的epoll bug,此处也许可以修改为:队列过多对应更多的轮询请求,增加系统负荷。

Example Errors

  1. Feature Behavior > Normal Message > Example:
sh mqadmin updateTopic -n <nameserver_address> -t <topic_name> -c <cluster_name> -a +message.type=Normal

# Normal -> NORMAL (case sensitive)
  1. Feature Behavior > Ordered Message > Example:
./bin/mqadmin updateTopic -c DefaultCluster -t FIFOTopic -o true -n 127.0.0.1:9876

# lack -a +message.type=FIFO
@Koado
Copy link
Contributor Author

Koado commented Jul 14, 2023

Languages Errors:
3. Use '/' instead of '\'.

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

No branches or pull requests

1 participant