Skip to content

Add Section 10: Units, Measurement & Locale (Design Standards v1.4)#76

Open
garthvh wants to merge 1 commit intomasterfrom
standards/v1.4-measurement-locale
Open

Add Section 10: Units, Measurement & Locale (Design Standards v1.4)#76
garthvh wants to merge 1 commit intomasterfrom
standards/v1.4-measurement-locale

Conversation

@garthvh
Copy link
Copy Markdown
Member

@garthvh garthvh commented May 9, 2026

What Changed

Adds Section 10: Units, Measurement & Locale to the Meshtastic Design Standards, bumping the version from v1.3 to v1.4.

Why

During a measurement/locale audit of the Apple client (meshtastic/Meshtastic-Apple#1764), we found 8 issues caused by ambiguous or missing guidance around unit handling. This section codifies the rules so all platform clients (Apple, Android, Web) follow consistent practices.

Key Additions

  • 10.1 Device Data Is Always Metric — Full table of every protobuf quantity and its metric unit
  • 10.2 Let the OS Handle Conversion — Platform-specific APIs (Apple/Android/Web) that automatically convert to the user's locale
  • 10.3 Display Conversion Table — What users see after OS conversion (metric vs imperial)
  • 10.4 Universal Units — Units that never convert (hPa, degrees, µR/hr)
  • 10.5 Implementation Rules — No hardcoded unit strings, no force-unwraps on locale lookups, chart axes must be locale-aware
  • 10.6 Date, Time & Calendar — Locale rules for temporal data
  • Updated Agent Checklist — 8 new measurement/locale compliance items

Files Changed

  • standards/meshtastic_design_standards_v1_4.md — New v1.4 document
  • standards/meshtastic_design_standards_latest.md — Symlink updated to point to v1.4

- All device/protobuf data is metric; conversions handled by client OS
- Platform API guidance for Apple, Android, and Web
- Display conversion table, universal units, implementation rules
- Date/time/calendar locale rules
- Updated agent checklist with 8 measurement/locale items
- Symlink updated to point to v1.4
@rcarteraz
Copy link
Copy Markdown
Member

Everything looks pretty reasonable to me. The colors provided, are they the same as the graphic that you shared previously?

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