Punctuate planplus long description

Co-authored-by: devtekve <7696966+devtekve@users.noreply.github.com>

sunnypilot/sunnylink/params_metadata.json

@@ -5,15 +5,17 @@
   },
   "AdbEnabled": {
     "title": "Enable ADB",
-    "description": ""
+    "description": "Allow ADB connections to the device.",
+    "long_description": "ADB (Android Debug Bridge) allows connecting to your device over USB or over the network. See https://docs.comma.ai/how-to/connect-to-comma for more info."
   },
   "AlphaLongitudinalEnabled": {
-    "title": "Alpha Longitudinal",
-    "description": ""
+    "title": "sunnypilot Longitudinal Control (Alpha)",
+    "description": "Enable sunnypilot longitudinal control alpha for this car (disables AEB).",
+    "long_description": "<b>WARNING: sunnypilot longitudinal control is in alpha for this car and will disable Automatic Emergency Braking (AEB).</b><br><br>On this car, sunnypilot defaults to the car's built-in ACC instead of sunnypilot's longitudinal control. Enable this to switch to sunnypilot longitudinal control. Enabling Experimental mode is recommended when enabling sunnypilot longitudinal control alpha. Changing this setting will restart sunnypilot if the car is powered on."
   },
   "AlwaysOnDM": {
-    "title": "Always-on Driver Monitor",
-    "description": ""
+    "title": "Always-On Driver Monitoring",
+    "description": "Enable driver monitoring even when sunnypilot is not engaged."
   },
   "ApiCache_Device": {
     "title": "Api Cache  Device",
@@ -82,11 +84,11 @@
     ]
   },
   "BackupManager_CreateBackup": {
-    "title": "Create Backup",
+    "title": "Backup Settings",
     "description": ""
   },
   "BackupManager_RestoreVersion": {
-    "title": "Restore Version",
+    "title": "Restore Settings",
     "description": ""
   },
   "BlindSpot": {
@@ -221,16 +223,17 @@
     "description": ""
   },
   "DeviceBootMode": {
-    "title": "Device Boot Mode",
-    "description": "",
+    "title": "Wake Up Behavior",
+    "description": "Choose device behavior after boot/sleep.",
+    "long_description": "Controls state of the device after boot/sleep.\n\nDefault: Device will boot/wake-up normally & will be ready to engage.\nOffroad: Device will be in Always Offroad mode after boot/wake-up.",
     "options": [
       {
         "value": 0,
-        "label": "Standard"
+        "label": "Default"
       },
       {
         "value": 1,
-        "label": "Always Offroad"
+        "label": "Offroad"
       }
     ]
   },
@@ -247,8 +250,8 @@
     "description": ""
   },
   "DisengageOnAccelerator": {
-    "title": "Disengage On Accelerator",
-    "description": ""
+    "title": "Disengage on Accelerator Pedal",
+    "description": "When enabled, pressing the accelerator pedal will disengage sunnypilot."
   },
   "DoReboot": {
     "title": "Reboot",
@@ -263,7 +266,7 @@
     "description": ""
   },
   "DongleId": {
-    "title": "Device ID",
+    "title": "Dongle ID",
     "description": ""
   },
   "DriverTooDistracted": {
@@ -283,8 +286,9 @@
     "description": ""
   },
   "EnableSunnylinkUploader": {
-    "title": "Enable sunnylink Uploader",
-    "description": ""
+    "title": "Enable sunnylink uploader (infrastructure test)",
+    "description": "Upload driving data to sunnypilot servers (tier-gated).",
+    "long_description": "Enable sunnylink uploader to allow sunnypilot to upload your driving data to sunnypilot servers. (Only for highest tiers, and does NOT bring ANY benefit to you yet. We are just testing data volume.)"
   },
   "EnforceTorqueControl": {
     "title": "Enforce Torque Control",
@@ -292,7 +296,8 @@
   },
   "ExperimentalMode": {
     "title": "Experimental Mode",
-    "description": ""
+    "description": "Enable alpha experimental features and new driving visualization.",
+    "long_description": "sunnypilot defaults to driving in chill mode. Experimental mode enables alpha-level features that aren't ready for chill mode. Experimental features are listed below:<br><h4>End-to-End Longitudinal Control</h4><br>Let the driving model control the gas and brakes. sunnypilot will drive as it thinks a human would, including stopping for red lights and stop signs. Since the driving model decides the speed to drive, the set speed will only act as an upper bound. This is an alpha quality feature; mistakes should be expected.<br><h4>New Driving Visualization</h4><br>The driving visualization will transition to the road-facing wide-angle camera at low speeds to better show some turns. The Experimental mode logo will also be shown in the top right corner."
   },
   "ExperimentalModeConfirmed": {
     "title": "Experimental Mode Confirmed",
@@ -355,7 +360,7 @@
     "description": ""
   },
   "HardwareSerial": {
-    "title": "Serial Number",
+    "title": "Serial",
     "description": ""
   },
   "HasAcceptedTerms": {
@@ -414,12 +419,13 @@
     "description": ""
   },
   "IsLdwEnabled": {
-    "title": "Lane Departure Warnings",
-    "description": ""
+    "title": "Enable Lane Departure Warnings",
+    "description": "Alert when drifting over lane lines without signaling.",
+    "long_description": "Receive alerts to steer back into the lane when your vehicle drifts over a detected lane line without a turn signal activated while driving over 31 mph (50 km/h)."
   },
   "IsMetric": {
-    "title": "Use Metric Units",
-    "description": ""
+    "title": "Use Metric System",
+    "description": "Display speed in km/h instead of mph."
   },
   "IsOffroad": {
     "title": "Is Offroad",
@@ -455,27 +461,30 @@
   },
   "LagdToggle": {
     "title": "Live Learning Steer Delay",
-    "description": "Allow device to learn and adapt car's steering response time"
+    "description": "Let the car learn and adapt its steering response time.",
+    "long_description": "Enable this for the car to learn and adapt its steering response time. Disable to use a fixed steering response time. Keeping this on provides the stock openpilot experience."
   },
   "LagdToggleDelay": {
-    "title": "Manual Software Delay",
-    "description": "Software delay to use when Live Learning Steer Delay is toggled off",
+    "title": "Adjust Software Delay",
+    "description": "Adjust the software delay when Live Learning Steer Delay is toggled off. The default software delay value is 0.2",
     "min": 0.05,
     "max": 0.5,
-    "step": 0.01
+    "step": 0.01,
+    "unit": "seconds"
   },
   "LagdValueCache": {
     "title": "LaGD Value Cache",
     "description": ""
   },
   "LaneTurnDesire": {
-    "title": "Lane Turn Desire",
-    "description": "Force model to plan an intent to turn based on blinker"
+    "title": "Use Lane Turn Desires",
+    "description": "Plan a turn at low speeds when signaling.",
+    "long_description": "If you're driving at 20 mph (32 km/h) or below and have your blinker on, the car will plan a turn in that direction at the nearest drivable path. This prevents situations (like at red lights) where the car might plan the wrong turn direction."
   },
   "LaneTurnValue": {
-    "title": "Lane Turn Speed",
-    "description": "Maximum speed for lane turn desire",
-    "min": 0,
+    "title": "Adjust Lane Turn Speed",
+    "description": "Set the maximum speed for lane turn desires. Default is 19 mph.",
+    "min": 5,
     "max": 20,
     "step": 1
   },
@@ -569,7 +578,8 @@
   },
   "LongitudinalPersonality": {
     "title": "Driving Personality",
-    "description": "",
+    "description": "Choose relaxed, standard, or aggressive following behavior.",
+    "long_description": "Standard is recommended. In aggressive mode, sunnypilot will follow lead cars closer and be more aggressive with the gas and brake. In relaxed mode sunnypilot will stay further away from lead cars. On supported cars, you can cycle through these personalities with your steering wheel distance button.",
     "options": [
       {
         "value": 0,
@@ -633,19 +643,68 @@
   },
   "MaxTimeOffroad": {
     "title": "Max Time Offroad",
-    "description": "",
-    "unit": "seconds"
+    "description": "Device will automatically shutdown after set time once the engine is turned off.\n(30h is the default)",
+    "options": [
+      {
+        "value": 0,
+        "label": "Always On"
+      },
+      {
+        "value": 5,
+        "label": "5m"
+      },
+      {
+        "value": 10,
+        "label": "10m"
+      },
+      {
+        "value": 15,
+        "label": "15m"
+      },
+      {
+        "value": 30,
+        "label": "30m"
+      },
+      {
+        "value": 60,
+        "label": "1h"
+      },
+      {
+        "value": 120,
+        "label": "2h"
+      },
+      {
+        "value": 180,
+        "label": "3h"
+      },
+      {
+        "value": 300,
+        "label": "5h"
+      },
+      {
+        "value": 600,
+        "label": "10h"
+      },
+      {
+        "value": 1440,
+        "label": "24h"
+      },
+      {
+        "value": 1800,
+        "label": "30h (Default)"
+      }
+    ]
   },
   "ModelManager_ActiveBundle": {
-    "title": "Model Manager Active Bundle",
+    "title": "Current Model",
     "description": ""
   },
   "ModelManager_ClearCache": {
-    "title": "Model Manager Clear Cache",
+    "title": "Clear Model Cache",
     "description": ""
   },
   "ModelManager_DownloadIndex": {
-    "title": "Model Manager Download Index",
+    "title": "Cancel Download",
     "description": ""
   },
   "ModelManager_Favs": {
@@ -653,7 +712,7 @@
     "description": ""
   },
   "ModelManager_LastSyncTime": {
-    "title": "Model Manager Last Sync Time",
+    "title": "Refresh Model List",
     "description": ""
   },
   "ModelManager_ModelsCache": {
@@ -711,7 +770,7 @@
     "description": ""
   },
   "OffroadMode": {
-    "title": "Force Offroad Mode",
+    "title": "Always Offroad",
     "description": ""
   },
   "Offroad_CarUnrecognized": {
@@ -845,7 +904,8 @@
   },
   "OpenpilotEnabledToggle": {
     "title": "Enable sunnypilot",
-    "description": ""
+    "description": "Enable sunnypilot adaptive cruise and lane keep.",
+    "long_description": "Use the sunnypilot system for adaptive cruise control and lane keep driver assistance. Your attention is required at all times to use this feature."
   },
   "OsmDbUpdatesCheck": {
     "title": "OSM DB Updates Check",
@@ -897,7 +957,8 @@
   },
   "PlanplusControl": {
     "title": "Plan Plus Controls",
-    "description": "Adjust planplus model recentering strength. The higher this number the more aggressively the model will recover to lanecenter, too high and it will ping-pong",
+    "description": "Adjust planplus model recentering strength.",
+    "long_description": "Adjust planplus model recentering strength. The higher this number the more aggressively the model will recover to lanecenter, too high and it will ping-pong.",
     "min": 0.0,
     "max": 2.0,
     "step": 0.1
@@ -919,16 +980,16 @@
     "description": ""
   },
   "RecordAudio": {
-    "title": "Record & Upload Mic Audio",
-    "description": ""
+    "title": "Record and Upload Microphone Audio",
+    "description": "Record and store microphone audio while driving. The audio will be included in the dashcam video in comma connect."
   },
   "RecordAudioFeedback": {
     "title": "Record Audio Feedback",
     "description": ""
   },
   "RecordFront": {
-    "title": "Record & Upload Driver Camera",
-    "description": ""
+    "title": "Record and Upload Driver Camera",
+    "description": "Upload data from the driver facing camera and help improve the driver monitoring algorithm."
   },
   "RecordFrontLock": {
     "title": "Record Front Lock",
@@ -1056,12 +1117,13 @@
     "description": ""
   },
   "SubaruStopAndGo": {
-    "title": "Subaru Stop and Go",
-    "description": ""
+    "title": "Stop and Go (Beta)",
+    "description": "Experimental feature to enable auto-resume during stop-and-go for certain supported Subaru platforms."
   },
   "SubaruStopAndGoManualParkingBrake": {
-    "title": "Subaru Stop and Go Manual Parking Brake",
-    "description": ""
+    "title": "Stop and Go for Manual Parking Brake (Beta)",
+    "description": "Enable stop-and-go for Subaru Global models with manual handbrake.",
+    "long_description": "Experimental feature to enable stop and go for Subaru Global models with manual handbrake. Models with electric parking brake should keep this disabled. Thanks to martinl for this implementation!"
   },
   "SunnylinkCache_Roles": {
     "title": "sunnylink Cache  Roles",
@@ -1072,12 +1134,12 @@
     "description": ""
   },
   "SunnylinkDongleId": {
-    "title": "sunnylink Dongle ID",
+    "title": "Dongle ID",
     "description": ""
   },
   "SunnylinkEnabled": {
-    "title": "sunnylink Enabled",
-    "description": ""
+    "title": "Enable sunnylink",
+    "description": "This is the master switch, it will allow you to cutoff any sunnylink requests should you want to do that."
   },
   "SunnylinkTempFault": {
     "title": "sunnylink Temp Fault",
@@ -1115,8 +1177,8 @@
     "unit": "m/s²"
   },
   "ToyotaEnforceStockLongitudinal": {
-    "title": "Toyota: Enforce Factory Longitudinal Control",
-    "description": "When enabled, sunnypilot will not take over control of gas and brakes. Factory Toyota longitudinal control will be used."
+    "title": "Enforce Factory Longitudinal Control",
+    "description": "sunnypilot will not take over control of gas and brakes. Factory Toyota longitudinal control will be used."
   },
   "TrainingVersion": {
     "title": "Training Version",