Update documentation (#17808)

Signed-off-by: Leo Siepel <leosiepel@gmail.com>

bundles/org.openhab.binding.hydrawise/README.md

@@ -6,33 +6,19 @@ The Hydrawise binding allows monitoring and control of [Hunter Industries's](htt
 
 ## Supported Things
 
-### Account Bridge Thing
+- `account`: Bridge type represents the user's account on the Hydrawise cloud service. The bridge can have one or more child [Controllers](#controller-thing) linked.
-
-The Account Bridge Thing type represents the user's account on the Hydrawise cloud service. The bridge can have one or more child [Controllers](#controller-thing) linked.
-
 An account must be manually added and configured.
+- `controller` Things are automatically discovered once an account Bridge is properly configured.[more details](#local-thing)
+- `local` Things uses an undocumented API that allows direct HTTP access to an irrigation controller on the user's network. [more details](#local-thing)
 
-### Controller Thing
+### `controller` Thing
-
-Controller Things are automatically discovered once an [Account Bridge](#account-bridge-thing) has be properly configured.
 
 The Controller Thing type is the primary way most users will control and monitor their irrigation system.
 This allows full control over zones, sensors and weather forecasts.<br>
 Changes made through this Thing type will be reflected in the Hydrawise mobile and web applications as well as in their reporting modules.
+Controller Things require a parent `account` Bridge
 
-Controller Things require a parent [Account Bridge](#account-bridge-thing)
+### `local` Thing
-
-#### Controller Thing Supported Channel Groups
-
-| channel group ID                              |
-|-----------------------------------------------|
-| [Controller](#controller-thing-1) |
-| [Zones](#zone-channel-group)                  |
-| [All Zones](#all-zones-channel-group)         |
-| [Sensor](#sensor-channel-group)               |
-| [Forecast](#forecast-channel-group)             |
-
-### Local Thing
 
 The Local Thing type uses an undocumented API that allows direct HTTP access to an irrigation controller on the user's network.
 This provides a subset of features compared to the Cloud Thing type limited to basic zone control.
@@ -45,16 +31,9 @@ Use Cases
 - The Local thing can be useful when testing zones, as there is no delay when starting/stopping zones as compared to the cloud API which can take anywhere between 5-15 seconds.
 - This is also useful if you wish to not use the cloud scheduling  at all and use openHAB as the irrigation scheduling system.
 
-#### Local Thing Supported Channel Groups
-
-| channel group ID                      |
-|---------------------------------------|
-| [Zones](#zone-channel-group)          |
-| [All Zones](#all-zones-channel-group) |
-
 ## Thing Configuration
 
-### Account Thing
+### `account` Bridge Configuration
 
 | Configuration Name | type    | required | Comments                                                                                                                  |
 |--------------------|---------|----------|---------------------------------------------------------------------------------------------------------------------------|
@@ -64,13 +43,13 @@ Use Cases
 | refresh            | Integer | False    | Defaults to a 60 second polling rate, more frequent polling may cause the service to deny requests                        |
 | refreshToken       | Boolean | False    | An oAuth refresh token, this will be automatically configured after the first login and updated as the token is refreshed |
 
-### Controller Thing
+### `controller` Thing Configuration
 
 | Configuration Name | type    | required | Comments             |
 |--------------------|---------|----------|----------------------|
 | controllerId       | Integer | True     | ID of the controller |
 
-### Local Thing
+### `local` Thing Configuration
 
 | Configuration Name | type    | required | Comments                                                                                                        |
 |--------------------|---------|----------|-----------------------------------------------------------------------------------------------------------------|
@@ -79,10 +58,27 @@ Use Cases
 | password           | String  | True     | Password set on the touch panel of the controller.  This can be found under the setting menu on the controller. |
 | refresh            | Integer | True     | Defaults to a 30 seconds polling rate                                                                           |
 
-## Channels
+## Channels and Groups
 
 ### Channel Groups
 
+### Controller Thing Supported Channel Groups
+
+| channel group ID                      |
+|---------------------------------------|
+| [Controller](#controller-thing-1)     |
+| [Zones](#zone-channel-group)          |
+| [All Zones](#all-zones-channel-group) |
+| [Sensor](#sensor-channel-group)       |
+| [Forecast](#forecast-channel-group)   |
+
+#### Local Thing Supported Channel Groups
+
+| channel group ID                      |
+|---------------------------------------|
+| [Zones](#zone-channel-group)          |
+| [All Zones](#all-zones-channel-group) |
+
 #### System Channel Group
 
 | channel group ID | Description                     |
@@ -161,6 +157,19 @@ Channels uses across zones, sensors and forecasts
 
 ## Full Example
 
+## `demo.things` Example
+
+```java
+Bridge hydrawise:account:myaccount "Hydrawise Cloud" [ userName="my-username", password="my-password", savePassword=true, refresh=120 ] {
+    Thing controller irrigation1 "Frontyard Controller" [ controllerId="12345" ]
+    Thing controller irrigation2 "Backyard Controller" [ controllerId="67890" ]
+}
+
+Thing local directIrrigation "Garden Controller" [ host="host-ip", username="my-username", password="my-password", refresh="30" ]
+```
+
+## `demo.items` Example
+
 ```java
 Group Sprinkler             "Sprinkler"
 Group SprinklerController   "Controller"    (Sprinkler)