doc updates and minor tweaks - go for v1.0.0

Author: andyfase

docs/index.md

@@ -62,11 +62,10 @@ function lightbox_close() {
 Features Include:
 {: .fs-6 .fw-300 }
 
-- Homescreen and Lockscreen Widgets
-- Optional background auto-updating of widget data
-- One Click Control Center icons for common commands
-- Siri voice support "Hey Siri, Warm the car"
+- Auto-Updating Homescreen and Lockscreen Widgets
 - Fresh and more responsive app UI
-- Automations via IOS Shortcuts like walk-away lock and auto warm the car on a schedule
+- Single click options for common commands (lock, warm, charge etc) in both app and in IOS Control Center
+- Siri voice support "Hey Siri, Warm the car"
+- Automations via IOS Shortcuts like walk-away lock
 - Unlimited Custom Climate configurations 
 {: .fs-6 .fw-300 }

docs/pages/features.md

@@ -7,47 +7,32 @@ nav_order: 3
 # Bluelink Scriptable feature set
 {: .fs-9 }
 
-The app is designed to perform  a subset of the main Hyundai / Kia app, but the subset that makes up for 99% of your usage. 
+The app is designed to perform a subset of the main Hyundai / Kia app, but the subset that makes up for 99% of your normal usage. 
 {: .fs-6 .fw-300 }
 
-The app is driven through the main widget, which can sit on any homescreen of your choosing - clicking on the widget opens the app automatically, swiping away closes it. The widget automatically updates the data displayed regularly, attempting to balance freshness of data while limiting the amount of remote connections to the car.
-{: .fs-5 .fw-300 }
 
-The app also supports the use of Siri Shortcuts, allowing you to ask siri to ***"get the status of the car"***, or ***"start warming the car"***. See the Siri Shortcuts section for more info.
+The app is driven through the main widget, which can sit on either your lockscreen or homescreen - clicking on the widget opens the app automatically, swiping away closes it. The widget automatically updates the data displayed regularly, attempting to balance freshness of data while limiting the amount of remote connections to the car.
 {: .fs-5 .fw-300 }
 
-**Status / Remote Status**
-{: .fs-5 .fw-200 }
-
-The app queries the Bluelink API to retireve information on the SOC (State of Charge), charging status, charging completion date/time, lock/unlock, climate and finally the 12v battery charge percentage.
-{: .fs-5 .fw-200 }
-
-The widget reguarly queries the bluelink API to retrieve the lastest data on the server, however this is typically cached data as the car only updates the bluelinks servers on very in-frequent basis. 
-{: .fs-5 .fw-200 }
-
-The app also supports performing "remote refreshes" which actually queries the car and gets the most upto date information from the car. Within the app clicking the status icon will cause a remote refresh, the widget can also perform remote refreshes on a schedule - this feature needs to be opted into within the settings screen.
-{: .fs-5 .fw-200 }
-
-> IMPORTANT NOTE: Too many remote refresh commands will drain the 12v battery in the car, which in a worst case situation will cause the car to not be able to start. The widget has been configured to be very careful on the number of remote refresh commands sent, however buyer beware - hence the opt-in - I take no liabiity for any 12v failures based on the abuse of this feature.
-
-**Start Charge / Stop Charge**
-{: .fs-5 .fw-200 }
-
-The app can stop or start charging the car. Click on the current charging status and choose start or stop.
-{: .fs-5 .fw-200 }
-
-**Climate Warm / Cool / Stop**
-{: .fs-5 .fw-200 }
-
-The app can stop or start the climate in the car, so you can pre-warm or pre-cool the car. Click on the current climate status and choose warm/cool/off.
-{: .fs-5 .fw-200 }
+[Multiple widget sizes are available](./widgets.md), data displayed varies based on the size available, but common items include:
+{: .fs-5 .fw-300 }
 
-**Lock / Unlock**
-{: .fs-5 .fw-200 }
+- Current battery state of charge
+- Icons to indicate charging, or charger connected
+- If charging, day/time charging will complete and the power level the car is charging at
+- Last date/time the car was queried for its current state
+{: .fs-4 .fw-300 }
 
-The app can lock of un-lock  the car. Click on the current lock status and choose lock or un-lock.
-{: .fs-5 .fw-200 }
+Using the main app and through the [IOS Control Center](./control-center.md) you can:
+{: .fs-5 .fw-300 }
 
+- Lock and Unlock the car
+- Pre warm/cool the car or use your own preset climate configurations
+- Start and Stop charging of the car
+- Change charge limits using your own pre-defined charge limit configurations
+{: .fs-5 .fw-300 }
 
+The app also supports the use of [Siri Shortcuts](./siri.md), allowing you to ask siri to ***"get the status of the car"***, or ***"start warming the car"***. See the Siri Shortcuts section for more info.
+{: .fs-5 .fw-300 }
 
 ----

docs/pages/install.md

@@ -7,10 +7,13 @@ nav_order: 4
 # Install Guide
 {: .fs-9 }
 
-Bluelink Scriptable is a "scriptable app". Its written in Javascript and runs within the scriptable IOS app. Using scriptable meant a vastly reduced amount of development time was required, and no pesky app store rejections (due to the use of the Bluelink API, technically this is against the terms and conditions of Bluelink) 
+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 }
 
-As such, installation is a little more than just "install an app" but honestly not that much 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!.
+{: .fs-5 .fw-300 } 
+
+## Install Steps
 
 Step 1: [Install the scriptable app](https://apps.apple.com/us/app/scriptable/id1405459188?uo=4)
 and open it.

src/about.ts

@@ -144,6 +144,9 @@ const upgrade = connect(({ state: { currentVersion, release } }) => {
                 const fm = FileManager.iCloud()
                 // try to backup current script - log errors, script could have been renamed for example
                 try {
+                  if (fm.fileExists(`${SCRIPTABLE_DIR}/${release.assetName}.backup`)) {
+                    fm.remove(`${SCRIPTABLE_DIR}/${release.assetName}.backup`)
+                  }
                   fm.move(`${SCRIPTABLE_DIR}/${release.assetName}`, `${SCRIPTABLE_DIR}/${release.assetName}.backup`)
                 } catch (e) {
                   logger.log(`Failed to backup current script: ${e}`)

src/widget.ts

@@ -157,7 +157,7 @@ export async function createMediumWidget(config: Config, bl: Bluelink) {
 
   // define widget and set date for when the next refresh should not occur before.
   const widget = new ListWidget()
-  widget.setPadding(20, 10, 20, 15)
+  widget.setPadding(20, 5, 20, 15)
   widget.refreshAfterDate = refresh.nextRefresh
 
   const mainStack = widget.addStack()