doc updates

Author: andyfase

docs/_config.yml

@@ -56,3 +56,10 @@ plugins:
 #   - vendor/cache/
 #   - vendor/gems/
 #   - vendor/ruby/
+callouts:
+  warning:
+    title: Warning
+    color: red
+  info:
+    title: Info
+    color: blue

docs/pages/automations.md

@@ -20,6 +20,13 @@ Below are a few example automations, and downloadable Shortcut scripts. The prov
 
 ### Walk Away Lock
 
+{: .warning-title }
+> Warning: You can lock yourself out of your car with this feature
+>
+> Locking via bluelink always locks regardless of your keys location. Thus auto-locking via bluelink means if you turn off the car, leave your keys in the car and leave the car - with the doors closed - you can get locked out.
+>
+> If using this feature never leave the car without one of your keys or your phone with the app installed (so you can un-lock when needed)
+
 This automation will send a lock command to the car, after a delay. The triggering event can either be disconnecting from CarPlay or disconnecting from the Car's Bluetooth.
 
 [Install "Auto Lock Car" Shortcut](https://www.icloud.com/shortcuts/2b49acde29904725b31c64f8195074ce)

docs/pages/install.md

@@ -7,10 +7,15 @@ nav_order: 4
 # Install Guide
 {: .fs-9 }
 
-Bluelink Scriptable is a "scriptable app". Its written in Javascript and runs within the [scriptable IOS app](https://scriptable.app/). Using scriptable meant a vastly reduced amount of development time was required, and no pesky app store rejections
-{: .fs-5 .fw-300 }
+{: .info-title }
+> This is not an "App Store" app
+>
+> Bluelink Scriptable is a "scriptable app". Its a "script" runs within the [scriptable IOS app](https://scriptable.app/), think of it as an app within a app. This means you install the scriptable app from the app store and then download the JS (Javascript) file into the scriptable directory on your phone.
+>
+>Using scriptable meant a vastly reduced amount of development time was required, no pesky app store rejections and quick fix times when Hyundai or Kia change their APIs! You still get close to the look and feel of a native app including widgets, Automations, Siri support and more!
+
 
-As such, installation is a couple more test than just "install an app". However once installed the app will prompt and auto-install new versions as they are released!.
+Instalation is a one time process. Once installed the app will prompt you when updates are released. The app includes a one-click upgrade process for ease of use.
 {: .fs-5 .fw-300 } 
 
 ## Install Steps

docs/pages/multi-car.md

@@ -7,18 +7,23 @@ nav_order: 7
 # Multiple Car Support
 {: .fs-9 }
 
-Since v1.2.0 the app supports the ability to have multiple cars configured (one per app script) with dedicated configuration per script created within Scriptable. This gives you the ability to have multiple widgets, each a car dedicated to each widget - with one-click access to perform car functions.
+{: .info-title }
+> Multiple Widgets one for each of your EVs.
+>
+> For households with more than one Hyundai or Kia EV you can effectively run multiple copies of the egmp-bluelink app, each one configured to fetch data on a specifically targeted car.
+>
+> Each car requires its own configuration and can be within the same Bluelink account or across different accounts or even Manufacturers
 {: .fs-5 .fw-300 }
 
 ## Enabling Multi-Car Support
 
-First setup the [script as normal](./install.md) for your first car. Ensure you specify the correct VIN within the settings for the car you wish to setup, enable the "Multi Car" setting if you have previously used older versions of the app than v1.2.0 - if you hadnt this setting is not needed.
+Since v1.2.0 multi-car support is enabled by default. Simply setup the [script as normal](./install.md) for your first car. 
 {: .fs-5 .fw-300 }
 
 Once setup, within the Scriptable app press and hold the "egmp-bluelink" row and select "Duplicate", this will bring up a code window - just click on "done". This will produce a script likely called "egmp-bluelink 1", feel free to rename to something more appropiate (press and hold and choose rename)
 {: .fs-5 .fw-300 }
 
-Now open the new script, it will prompt for Bluelink settings as per the first install, proceed to configure the same settings but this time select the second car's VIN. Once setup you can configure a new widget for this second car - just ensure when you configure the widget you select the new scriptable script.
+Now open the new script, it will prompt for Bluelink settings as per the first install, proceed to configure the same settings but your second car. Once setup you can configure a new widget for this second car - just ensure when you configure the widget you select the new scriptable script.
 {: .fs-5 .fw-300 }
 
 

docs/pages/widgets.md

@@ -7,10 +7,20 @@ nav_order: 2
 # Widget Support
 {: .fs-9 }
 
-Bluelink Scriptable supports two sizes of both Lockscreen and Homescreen widgets. All widgets provide single click access to the main app and all widgets will auto-update in the background.
+Bluelink Scriptable supports  both Lockscreen and Homescreen widgets. 
 {: .fs-6 .fw-300 }
 
-It should be noted that there is a optional opt-in setting within the Settings screen called "Enable widget remote refresh" once enabled, the auto-updating of widget data will include sending intermittent remote status commands to the car. This is required to get the latest data from the car directly vs cached data from the Bluelink servers.
+All widgets provide single click access to the main app and all widgets allow for auto-updating of car data in the background.
+{: .fs-5 .fw-300 }
+
+{: .info-title }
+> Remote Widget Refresh
+>
+> It should be noted that auto-updating of car data is "opt-in" you are required to check the setting "Enable widget remote refresh" in the settings screen to enable this feature. This feature will auto send intermittent remote status commands to the car to obtain up-to date data on the status of your car.
+>
+> This is required to get the latest data from the car directly, without enabiling this setting it is likely your widget will always display stale data.
+>
+> 12V battery drain can occur if you send too many remote refresh commands. The defaults set in the app are very conservative for this reason. Only play with the advanced widget settings if you understand the potential consequences of sending too many commands.
 {: .fs-5 .fw-300 }
 
 ## Home Screen Widgets