emqx / emqx/emqx-docs

Several improvement suggestions for the MQTT Bridge documentation

Open
#2,114 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
174
Forks
293
Avg merge
1d 3h
Merged PRs (30d)
127

Description

File: [/en_US/data-integration/data-bridge-mqtt.md](https://www.emqx.io/docs/en/v5.1/data-integration/data-bridge-mqtt.html)

When I need to establish a bidirectional MQTT bridge, EMQX currently supports three configuration methods:
1. Create a bridge on a node and configure ingress and egress at the same time
2. Create bridges on both nodes and configure egress on both nodes.
3. Create bridges on the two nodes and configure ingress on both nodes.

But now the documentation fails to tell me what is the difference between these configuration methods. What scenarios are they suitable for?

For example, when I need all clients to publish messages to the topic `bridge/topic` and subscribe to `remote/bridge/topic`, which configuration method should be used? Or what are the requirements for topic design of different configuration methods?

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with /en_US/data-integration/data-bridge-mqtt.md and review the three bidirectional MQTT bridge configuration methods described in the issue. Document how they differ, which scenarios suit each method, topic-design requirements, and which method fits publishing to bridge/topic and subscribing to remote/bridge/topic. Confirm the examples are clear and actionable for readers.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.