Skip to content

Commit 352c359

Browse files
committed
Add pre-connection status messages to STATUS_MESSAGES.md for improved user guidance
1 parent 9fc112d commit 352c359

1 file changed

Lines changed: 19 additions & 1 deletion

File tree

docs/STATUS_MESSAGES.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -561,7 +561,23 @@ These messages use a hybrid approach: **first display respects 500ms minimum**,
561561
- **When**: Browser tab hidden while RX Auto mode running
562562
- **Source**: `content/wardrive.js:visibilitychange handler`
563563

564-
#### 10. Error Messages
564+
#### 10. Pre-Connection Status Messages
565+
566+
##### Select external antenna to connect
567+
- **Message**: `"Select external antenna to connect"`
568+
- **Color**: Amber (warning)
569+
- **When**: On app load or when disconnected, if external antenna option is not selected (but zone check has passed)
570+
- **Terminal State**: Yes (persists until external antenna is selected)
571+
- **Notes**: Displayed in Dynamic Status Bar as a warning message to guide user that Connect button is disabled. Once external antenna is selected and zone check passes, status changes to "Idle" (em dash) and Connect button becomes enabled.
572+
- **Source**: `content/wardrive.js:updateConnectButtonState()`
573+
574+
##### Waiting for location...
575+
- **Message**: `"Waiting for location..."`
576+
- **Color**: Blue (info)
577+
- **When**: External antenna is selected but zone check is still in progress (location display shows "Checking...")
578+
- **Terminal State**: Yes (persists until zone check completes)
579+
- **Notes**: Displayed in Dynamic Status Bar to inform user that the app is waiting for GPS location and zone validation before allowing connection. Once zone check passes, status changes to "Idle" and Connect button becomes enabled.
580+
- **Source**: `content/wardrive.js:updateConnectButtonState()`
565581

566582
##### Select radio power to connect
567583
- **Message**: `"Select radio power to connect"`
@@ -571,6 +587,8 @@ These messages use a hybrid approach: **first display respects 500ms minimum**,
571587
- **Notes**: Displayed in Dynamic Status Bar as a warning message to guide user that Connect button is disabled. Once radio power is selected, status changes to "Idle" (em dash) and Connect button becomes enabled.
572588
- **Source**: `content/wardrive.js:updateConnectButtonState()`
573589

590+
#### 11. Error Messages
591+
574592
##### Connection failed
575593
- **Message**: `"Connection failed"` or specific error message
576594
- **Color**: Red (error)

0 commit comments

Comments
 (0)