Skip to content

Commit c9c2f53

Browse files
jamesarichCopilot
andcommitted
docs: add meshtastic.org cross-links, Crowdin, FAQ, and hardware refs
Adds external links to meshtastic.org docs across 9 user guide pages: - Getting started guide, hardware/devices list, FAQ - LoRa configuration, channel configuration, module configuration - MQTT integration, ATAK plugin, firmware flashing guides - Web Flasher and Crowdin project links - Remote admin troubleshooting section Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 9a31da7 commit c9c2f53

9 files changed

Lines changed: 39 additions & 2 deletions

File tree

docs/user/connections.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,7 @@ See [Desktop App](desktop) for platform-specific details and keyboard shortcuts.
107107
- [Getting Started](onboarding) — first-launch setup and permissions
108108
- [Settings — Radio & User](settings-radio-user) — Bluetooth and network configuration
109109
- [Desktop App](desktop) — desktop-specific connection details
110+
- [Supported devices](https://meshtastic.org/docs/hardware/devices) — full list of compatible radios on meshtastic.org
110111

111112
---
112113

docs/user/desktop.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -119,5 +119,10 @@ Requirements:
119119
- Some Android-specific features (widgets, specific notification channels) are unavailable
120120
- Performance may vary on low-spec hardware running Compose Desktop
121121

122+
## Related Topics
123+
124+
- [Connections](connections) — connection methods overview
125+
- [Firmware Updates](firmware) — use the [Web Flasher](https://flasher.meshtastic.org) for desktop firmware updates
126+
122127
---
123128

docs/user/firmware.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ The most common update method for Android users:
4242

4343
For recovery or when OTA is unavailable:
4444
- Use the [Meshtastic Web Flasher](https://flasher.meshtastic.org)
45-
- Or the Meshtastic CLI tool on desktop
45+
- Or the [Meshtastic CLI tool](https://meshtastic.org/docs/getting-started/flashing-firmware) on desktop
4646

4747
## Version Channels
4848

@@ -95,5 +95,12 @@ The app may show warnings when:
9595

9696
> ⚠️ **Important:** Always update the Meshtastic app before or alongside firmware updates to ensure compatibility.
9797
98+
## Related Topics
99+
100+
- [Connections](connections) — reconnecting after a firmware update
101+
- [Flashing firmware guide](https://meshtastic.org/docs/getting-started/flashing-firmware) — full firmware flashing walkthrough on meshtastic.org
102+
- [Supported devices](https://meshtastic.org/docs/hardware/devices) — check firmware compatibility by device
103+
- [FAQ](https://meshtastic.org/docs/about/faq) — common questions on meshtastic.org
104+
98105
---
99106

docs/user/messages-and-channels.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -124,6 +124,7 @@ Messages are queued and transmitted based on priority:
124124
- [Nodes](nodes) — tap a node to start a direct message
125125
- [Settings — Radio & User](settings-radio-user) — configure channel encryption and presets
126126
- [MQTT](mqtt) — bridge channel messages to the internet
127+
- [Channel configuration](https://meshtastic.org/docs/configuration/radio/channels) — detailed channel settings on meshtastic.org
127128

128129
---
129130

docs/user/mqtt.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,7 @@ Understanding the layered encryption model:
127127

128128
- [Settings — Modules & Admin](settings-module-admin) — MQTT module configuration reference
129129
- [Messages & Channels](messages-and-channels) — channel encryption and PSK setup
130+
- [MQTT integration guide](https://meshtastic.org/docs/software/integrations/mqtt) — detailed MQTT documentation on meshtastic.org
130131

131132
---
132133

docs/user/onboarding.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -87,4 +87,6 @@ Once connected to a radio, explore:
8787
- [Map & Waypoints](map-and-waypoints) — view node positions
8888
- [Settings](settings-radio-user) — configure your radio and user profile
8989

90+
New to Meshtastic? The [getting started guide](https://meshtastic.org/docs/getting-started) on meshtastic.org covers hardware selection, initial radio configuration, and your first mesh setup.
91+
9092
---

docs/user/settings-module-admin.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -219,5 +219,17 @@ View detailed diagnostic information:
219219
- Mesh packet log
220220
- Connection state details
221221

222+
### Troubleshooting Remote Admin
223+
224+
- **"No response from target node"** — the target may be out of range, offline, or have a mismatched admin key. Verify the admin key matches on both nodes.
225+
- **Changes not applying** — some settings require a reboot to take effect. Try the Reboot action after saving.
226+
- **Can't see remote settings** — ensure your node has the admin key for the target node and that Admin Channel is enabled in Security Config.
227+
228+
## Related Topics
229+
230+
- [Settings — Radio & User](settings-radio-user) — core radio and user profile settings
231+
- [Module configuration reference](https://meshtastic.org/docs/configuration/module) — detailed module docs on meshtastic.org
232+
- [FAQ](https://meshtastic.org/docs/about/faq) — common questions on meshtastic.org
233+
222234
---
223235

docs/user/settings-radio-user.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ After modifying settings, tap **Save** to write the configuration to your radio.
5454
| Frequency Offset | Fine-tune frequency (MHz) | 0 |
5555
| Channel Bandwidth | Bandwidth setting | Default for preset |
5656

57-
> ⚠️ **Important:** You **must** set your region before transmitting. Operating without the correct region may violate local radio regulations.
57+
> ⚠️ **Important:** You **must** set your region before transmitting. Operating without the correct region may violate local radio regulations. See the [region configuration guide](https://meshtastic.org/docs/getting-started/initial-config) on meshtastic.org for details.
5858
5959
### Modem Presets
6060

@@ -134,5 +134,12 @@ Settings use standard preference controls — dropdowns, toggles, and sliders:
134134
| Toggle | ![Toggle](/assets/screenshots/settings_switch.png) |
135135
| Slider | ![Slider](/assets/screenshots/settings_slider.png) |
136136

137+
## Related Topics
138+
139+
- [Settings — Modules & Admin](settings-module-admin) — optional feature modules and device administration
140+
- [Signal Meter](signal-meter) — how modem presets affect signal quality thresholds
141+
- [LoRa configuration](https://meshtastic.org/docs/configuration/radio/lora) — detailed LoRa settings reference on meshtastic.org
142+
- [Initial configuration](https://meshtastic.org/docs/getting-started/initial-config) — region setup guide on meshtastic.org
143+
137144
---
138145

docs/user/tak.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,7 @@ Once configured:
8181
- [Settings — Modules & Admin](settings-module-admin) — TAK module configuration
8282
- [Nodes](nodes) — TAK and TAK Tracker roles in the node list
8383
- [Map & Waypoints](map-and-waypoints) — node positions on the map
84+
- [ATAK plugin guide](https://meshtastic.org/docs/software/integrations/atak-plugin) — detailed ATAK setup on meshtastic.org
8485

8586
---
8687

0 commit comments

Comments
 (0)