Skip to content

docs: full wiki review against current server and app - #30

Merged
MrAlders0n merged 20 commits into
mainfrom
docs/wiki-review-2026-09
Sep 29, 2026
Merged

MrAlders0n merged 20 commits into
mainfrom
docs/wiki-review-2026-09

Conversation

@MrAlders0n

Copy link
Copy Markdown
Contributor

Page-by-page review of the whole wiki, with every page checked against the current server (MeshMapper_Server) and app (MeshMapper_Flutter_App origin/dev) code.

Highlights

  • Shared links keep wiki. — site_url was https://meshmapper.net, so canonical/share links dropped the wiki. host. Now https://wiki.meshmapper.net/.
  • Relative links everywhere — internal links are relative, so mkdocs build --strict catches broken ones.
  • MQTT — new Native Firmware page (built-in meshmapper preset); Python guide switched to Cisien's meshcoretomqtt; recommended order Firmware → Home Assistant → meshcoretomqtt → PyMC; MeshMapper broker only.
  • Onboarding / Region Boundaries — match the current wizard and OSM Load Boundary editor; custom GeoJSON is special-circumstances only; old editor screenshots removed.
  • Map pages — Layers, Visuals, Backbone, Multi-Byte, Duplicate IDs and Override rewritten against the current map (Repeater Scopes, Antenna Coverage, Scope Finder, Insights, share-link params, ID width, collision Rules A/B, backbone link counts).
  • New diagrams — multiregion duplicate-ID and ping-type SVGs stored in the repo (no longer hot-linked from the main site).
  • Community / Admin / API / Support — Leaderboards (Pioneers, Explorers, new boards), Awards, Portal (Discord sign-in, 12-char passwords), Embedding, Admin Portal (real tab order, per-preset Radio Channels, CARpeaters), Webhooks (6 events, failure pause/disable), Coverage/Zones/Scopes APIs, Troubleshooting, Bot Commands.
  • Mobile App (9 pages) — web app removed (no longer published), Quick Guide, antenna labels, flood-off default, real connection/disconnect behaviour, scope discovery, third-party payload fields.
  • Privacy Policy — corrected to match what is actually collected, retained and shared (MQTT broker, deletion scope, retention, app-token IPs, bot logs, feedback reports, backups). Please review this one carefully.

Not reviewed

  • Release notes (historical) — only their links were made relative.

Follow-up issues filed

#561 #562 #564 #565 #566 #567 #568 #569 #570 #571 #572 #573 #574 (and a comment on #531).

Test plan

  • mkdocs build --strict passes locally
  • Skim Admin Portal and Privacy Policy
  • After deploy, check a shared page link keeps wiki.meshmapper.net

…edits

Fix typos, link the privacy policy, describe passive fallback when a
region's transmit slots are full, and play down leaderboards in favour of
network planning.
Rewrite around the Code / Region / Boundary / Mesh / Submit steps, OSM
Load Boundary levels, the MeshMapper broker only, public admin listing,
and scopes guidance. Drop the legacy data section.
…etomqtt

- New Native Firmware page using the built-in meshmapper preset
- Replace meshcore-packet-capture with Cisien's meshcoretomqtt
- Recommend observers in order: firmware, Home Assistant, meshcoretomqtt, PyMC
- Update Home Assistant labels, PyMC IATA guidance, shared verify section
- Set site_url to wiki.meshmapper.net so shared links keep the wiki. host
Drop claims that don't hold (group-only session handoff, suggestion
lines, shared notes, sub-region filter) and replace the hosted image
with an SVG in the repo.
- Layers: navbar, coverage modes, Repeater Scopes, Antenna Coverage,
  Scope Finder, Insights, settings sections, ID width filter, share links
- Visuals: real status labels, sidebar-first details, redrawn ping types SVG
- Backbone: link counts build up and drop after N silent days, setting
  names, preset/same-spot rules, remove the September box
Add The Rules (Rule A / Rule B), correct leaderboard behaviour, per-preset
Enforce Hybrid, status-based manual resolution, and drop duplicated
multi-byte content.
…aviour, rewrite region boundaries for the OSM editor

Remove the old Leaflet editor screenshots and QGIS walkthrough; custom
GeoJSON is now special-circumstances only.
…viour

Pioneer awards, Discord sign-in, 12-character passwords, portal tabs,
repeater claims, embed cvd/preset/dir params and the repeater grid.
… use relative wiki links

Relative links are checked by mkdocs --strict, so broken links fail the
build instead of shipping.
Correct the MQTT broker entry, portal deletion scope and repeater
retention; disclose app-token IPs, altitude, passive advert records, bot
logs, feedback reports, site statistics and backups.
Follow the real tab order; per-preset Radio Channels; Ambiguous status;
CARpeaters tab; Brokers badges; My Account; group defaults; remove the
retired Users tab and settings that no longer exist.
Drop the unpublished web app; Quick Guide; antenna labels; flood-off
regions; zone chip states; Connect tab layout; Scan and step labels.
…gainst the app

Correct BLE roles, RX logging, DISC matching and filter steps; add scope
discovery; real error messages and hint labels; third-party payload
fields, timing and SCOPES behaviour; drop web content.
Flood auto-on at connect, force-only Hybrid, Trace when zone is full,
running-button labels, settings defaults, pre-connect zone check,
per-preset region rules, idle disconnect and real disconnect order.
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.

1 participant