Skip to content

Restore lost guide content and broker access references - #89

Merged
MrAlders0n merged 5 commits into
mainfrom
restore-lost-content
Sep 3, 2026
Merged

Restore lost guide content and broker access references#89
MrAlders0n merged 5 commits into
mainfrom
restore-lost-content

Conversation

@MrAlders0n

@MrAlders0n MrAlders0n commented Sep 3, 2026

Copy link
Copy Markdown
Member

This restores useful community guidance that was trimmed during the site overhaul, keeps the overhaul's safety and verification structure, and folds the MQTT broker reference work from #88 into one reviewable change.

Restored and updated

  • Restores the bilingual wire-connector reference and adds it to the Devices & Builds navigation.
  • Adds the bilingual experimental 1 W solar repeater guide to the navigation while keeping its electrical, RF, battery, and site-review gates.
  • Restores the companion and antenna recommendations, prices, local suppliers, connector warnings, and DIY companion example.
  • Restores the MeshCore project-split notice and expanded device-role guidance.
  • Restores the bilingual MQTT broker administrator contacts.
  • Documents the current read-only subscriber inventory, including hansimgamr for Quinte Mesh.

Corrections made during review

  • Describes dedicated repeaters as the recommended routing backbone without incorrectly claiming that room servers can never repeat.
  • Corrects the room-server history wording to 32 unseen messages.
  • Makes clear that the WisMesh Tag ships with Meshtastic and must be flashed with MeshCore before use.
  • Limits replacement-antenna advice to devices with removable antennas.
  • Removes stale claims about a cheaper unflashed T-Echo, guaranteed duty treatment, and the T-Deck Plus being designed for MeshCore.
  • Replaces the unfinished-page label on the connector reference and names connector pitch correctly.

The role and firmware corrections were checked against the current MeshCore FAQ, MeshCore configurator, official MeshCore hardware/flasher page, and RAK WisMesh Tag documentation.

Validation

  • node --test tests/content/*.test.mjs — 74 passed
  • python -m unittest discover -s tests/content — 14 passed
  • strict bilingual site build and built-link validation — 129 pages and 13,170 local references passed
  • Chromium browser suite — 66 passed, 5 intentionally skipped
  • git diff --check — clean

PR #88 is included in this branch and can be closed once this push is confirmed.

@n30nex n30nex left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I found three accuracy issues that should be corrected before this is merged:

  1. The role matrix and details say only dedicated repeaters route traffic, but current room-server firmware can repeat. The official FAQ says this is supported but not recommended, and the official configurator currently exposes the room-server Repeat setting. Dedicated repeaters should be described as the recommended backbone, not the only devices capable of forwarding traffic.

  2. The WisMesh Tag is described as pre-flashed for instant use. RAK documents that it ships with Meshtastic, so a MeshCore reader still needs to flash the current MeshCore companion firmware.

  3. The antenna warning says every listed companion needs an upgraded antenna, but the T1000-E and WisMesh Tag use internal antennas; RAK also warns that opening the Tag damages the enclosure. The advice should be limited to devices with replaceable antennas.

I also found a few smaller stale purchasing claims (the T-Echo firmware variant, guaranteed duty treatment, and “built with MeshCore in mind” wording for the T-Deck Plus). I’m correcting these in English and French and folding #88 into this branch so the repository has one reviewable PR.

@n30nex n30nex changed the title Restore guide content trimmed in the site overhaul Restore lost guide content and broker access references Sep 3, 2026
@n30nex

n30nex commented Sep 3, 2026

Copy link
Copy Markdown
Member

Review follow-up: the accuracy issues I called out above are fixed in 109d241, and PR #88 is now fully folded into this branch and closed.

The unified PR now restores the bilingual guide content, corrects room-server/client-repeat wording, fixes the WisMesh Tag and sealed-antenna guidance, removes stale purchase claims, restores the broker administrator contacts, and lists hansimgamr for Quinte Mesh.

Verified on the exact pushed commit:

  • validation: passed
  • Lighthouse: passed
  • hosted browser suite: passed
  • local content tests: 74 passed
  • local Python content tests: 14 passed
  • strict bilingual build/link check: 129 pages and 13,170 references passed
  • local Chromium suite: 66 passed, 5 intentionally skipped
  • final repository guard: clean worktree, exact local/remote SHA, no blockers

This is ready for a fresh maintainer review.

@MrAlders0n
MrAlders0n merged commit c756901 into main Sep 3, 2026
3 checks passed
@MrAlders0n
MrAlders0n deleted the restore-lost-content branch September 3, 2026 20:21
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.

2 participants