Add Units, Measurement & Locale user guide page#1766
Merged
Conversation
- New docs/user/units-and-locale.md covering how the app automatically adapts temperatures, distances, speeds, weight, rainfall, and date/time formatting to the user's device locale settings - Documents where to change measurement system and date/time settings on iOS and macOS - Explains universal units that never convert (hPa, degrees, µR/hr) - Added What's New entry and Quick Links reference - Regenerated bundled HTML docs
- Captured iOS Settings → General → Language & Region screenshot showing Temperature, Measurement System, Calendar, Date Format, and Number Format settings - Added settings summary table linking each setting to its effect in the Meshtastic app - Removed redundant 'where to change it' tables now covered by the screenshot - Rebuilt bundled HTML docs and copied screenshots
- Replaced iOS 18 screenshot with iOS 26 Language & Region screen - Added First Day of Week to settings summary table - Shows Region Format Example preview at bottom of screen
Lists screenshots captured manually (e.g., iOS Simulator Settings screens) so future cleanup scripts know not to delete them.
- New scripts/cleanup-screenshots.sh removes orphaned PNGs from docs/assets/screenshots/ that are not referenced in any markdown file and not listed in MANUAL_SCREENSHOTS - Supports --dry-run to preview deletions without removing files - Integrated into copy-snapshots.sh so cleanup runs automatically whenever screenshots are copied to the app bundle
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What Changed
New user-facing documentation page explaining how the app automatically adapts units, measurements, and date/time formatting to the user's device locale settings.
Why
Following the measurement/locale audit (#1764) and the new design standards (meshtastic/design#76), users need a clear reference explaining that unit conversion is automatic and where to change their system settings.
New Files
docs/user/units-and-locale.md— Full user guide covering temperature, distance, altitude, speed, wind, weight, rainfall, barometric pressure, and date/time formattingdocs/assets/screenshots/settingsLanguageRegion.png— iOS 26 Settings → Language & Region screenshotdocs/assets/screenshots/MANUAL_SCREENSHOTS— Manifest for non-test-generated screenshotsscripts/cleanup-screenshots.sh— Removes orphaned PNGs not referenced in docs or listed in MANUAL_SCREENSHOTSChanges to Existing Files
docs/index.md— Added Units & Locale quick linkdocs/user.md— Added What's New entryscripts/copy-snapshots.sh— Integrated automatic cleanup after copyHow It Was Tested
cleanup-screenshots.sh --dry-runconfirms 0 orphans across 88 screenshotsbuild-docs.shgenerates the new HTML page successfullyScreenshots
The new page includes an iOS 26 Settings → Language & Region screenshot showing Temperature, Measurement System, Calendar, First Day of Week, Date Format, and Number Format settings.