Improve flick_electric documentation (#37388)

* Improve flick_electric documentation

* Fix grammar

* Remove scale for now

* tiny tweak

* remove redundant fields in configuration_basic block

* add abbreviation tooltip

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

source/_integrations/flick_electric.markdown

@@ -18,10 +18,107 @@ ha_integration_type: service
 
 {% include integrations/config_flow.md %}
 
+{% configuration_basic %}
+Username:
+    description: "Username used to log into Flick Electric."
+Password:
+    description: "Password used to log into Flick Electric."
+Client ID:
+    description: "Client ID to authenticate (see below note)."
+Client Secret:
+    description: "Client Secret to authenticate (see below note)."
+Account:
+    description: "Address of the account to add (required when user has multiple active accounts)."
+{% endconfiguration_basic %}
+
 {% note %}
 
-The configuration uses the client ID and secret used by the app at the time of release. If this stops working, you can find the new ones by using a MITM proxy with the mobile app. The app will call `https://api.flick.energy/identity/oauth/token` with the `client_id` and `client_secret`.
+For most users, Client ID/Secret can be left blank.
 
-You can then use these values during the configuration.
+Home Assistant by default uses the client ID and secret from the Flick Electric mobile app at the time of release.
+
+If this stops working, you can find the new ones by using a MITM proxy with the mobile app. The app will call `https://api.flick.energy/identity/oauth/token` with the `client_id` and `client_secret`.
 
 {% endnote %}
+
+## Supported functionality
+
+The integration provides a `sensor` entity with the power price for the current time interval.
+
+The attributes of the entity have a breakdown of the pricing components, such as `generation` and `network` charges.
+
+{% note %}
+
+The power price shown is in cents, and is *excluding <abbr title="goods and services tax">GST</abbr>*. You can customize this by creating a template sensor:
+
+1. Go to
+{% my helpers title="**Settings** > **Devices** & **Services** > **Helpers**" %} and click the add button;
+2. Choose the **{% my config_flow_start domain="template" title="Template" %}** option
+3. Select **Add a template sensor**.
+
+{% raw %}
+
+To add GST:
+
+- **State template**: `{{ states.sensor.flick_power_price * 1.15 }}`
+- **Unit of measurement**: `¢/kWh`
+
+To convert to dollars:
+
+- **State template**: `{{ states.sensor.flick_power_price / 100 }}`
+- **Unit of measurement**: `$/kWh`
+
+{% endraw %}
+
+{% endnote %}
+
+## Use cases
+
+This integration can be used as part of an automation, for example to turn on/off appliances automatically.
+
+## Example automations
+
+{% details "Turn off the heat pump when price is above 40¢/kWH" %}
+
+{% raw %}
+
+```yaml
+alias: "Turn off expensive heat pump"
+description: "Turn off the heat pump when price is above 40¢/kWH"
+triggers:
+  - trigger: numeric_state
+    entity_id: sensor.flick_power_price
+    above: 40
+actions:
+  - action: climate.turn_off
+    target:
+      entity_id: climate.heat_pump
+    data: {}
+```
+
+{% endraw %}
+{% enddetails %}
+
+## Data updates
+
+The integration will {% term polling poll %} the Flick Electric API every 5 minutes to check for the current power price. You can also use the `homeassistant.update_entity` action to trigger a refresh on-demand.
+
+## Remove integration
+
+This integration follows standard integration removal, no extra steps are required.
+
+{% include integrations/remove_device_service.md %}
+
+## Troubleshooting
+
+{% details "Cannot get pricing for this account. Please check user permissions" %}
+
+API is unable to find pricing for the selected account. Check with Flick Electric to ensure that your user is configured correctly.
+
+{% enddetails %}
+
+{% details "No services are active on this Flick account" %}
+
+Only active accounts are supported by this integration. If your account is active but is not able to be selected, check with Flick Electric to ensure that it is showing as active in their system.
+
+{% enddetails %}