Fix documentation, grammar, and spelling in bindings Q-S

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

@@ -2,27 +2,27 @@
 
 This binding for [Qbus](https://qbus.be) communicates with all controllers of the Qbus home automation system.
 
-We also host a site which contains a [manual](https://iot.qbus.be/) where you can find lots of information to set up openHAB with Qbus client and server (for the moment only in Dutch).
+We also host a site with a [manual](https://iot.qbus.be/) containing information to set up openHAB with Qbus client and server (currently only in Dutch).
 
-The controllers can not communicate directly with openHAB, therefore we developed a client/server application which you must install prior to enable this binding.
+The controllers cannot communicate directly with openHAB, so you must install a client/server application prior to enabling this binding.
 More information can be found here:
 [Qbus Client/Server](https://github.com/QbusKoen/QbusClientServer-Installer)
 
-With this binding you can control and read almost every output from the Qbus system.
+With this binding, you can control and read almost every output from the Qbus system.
 
 ## Supported Things
 
 The following things are supported by the Qbus binding:
 
-- `dimmer`: Dimmer 1 button, 2 button and clc
-- `onOff`: Bistabiel, Timer1-3, Interval
-- `thermostats`: Thermostats - normal and PID
+- `dimmer`: Dimmer (1-button, 2-button, and CLC)
+- `onOff`: Bistabiel, Timer 1–3, Interval
+- `thermostats`: Thermostats (normal and PID)
 - `scene`: Scenes
 - `co2`: CO2
 - `rollershutter`: Rollershutter
-- `rollershutter_slats`: Rollerhutter with slats
+- `rollershutter_slats`: Rollershutter with slats
 
-For now the following Qbus things are not yet supported but will come:
+For now, the following Qbus things are not yet supported but will come:
 
 - DMX
 - Timer 4 & 5
@@ -36,9 +36,9 @@ For now the following Qbus things are not yet supported but will come:
 
 ## Discovery
 
-The discovery service is not yet implemented but the System Manager III software of Qbus generates things and item files from the programming, which you can use directly in openHAB.
+The discovery service is not yet implemented, but the System Manager III software of Qbus generates things and item files from the programming that you can use directly in openHAB.
 
-## Bridge configuration
+## Bridge Configuration
 
 ```java
 Bridge qbus:bridge:CTD001122 [ addr="localhost", sn="001122", port=8447, serverCheck=10 ] {
@@ -48,24 +48,24 @@ Bridge qbus:bridge:CTD001122 [ addr="localhost", sn="001122", port=8447, serverC
 
 | Property      | Default   | Required | Description                                                                                                                          |
 |---------------|-----------|----------|--------------------------------------------------------------------------------------------------------------------------------------|
-| `addr`        | localhost | YES      | The ip address of the machine where the Qbus Server runs                                                                             |
+| `addr`        | localhost | YES      | The IP address of the machine where the Qbus server runs                                                                             |
 | `sn`          |           | YES      | The serial number of your controller                                                                                                 |
 | `port`        | 8447      | YES      | The communication port of the client/server                                                                                          |
 | `serverCheck` | 10        | NO       | Refresh time - After x minutes there will be a check if server is still running and if client is still connected. If not - reconnect |
 
-## Things configuration
+## Things Configuration
 
-| Thing Type ID         | Channel Name  | Read only | description                                            |
-| --------------------- | ------------- | --------- | ------------------------------------------------------ |
-| `onOff`               | switch        | No        | This is the channel for Bistable, Timers and Intervals |
-| `dimmer`              | brightness    | No        | This is the channel for Dimmers 1&2 buttons and CLC    |
-| `scene`               | Switch        | No        | This is the channel for scenes                         |
-| `co2`                 | co2           | Yes       | This is the channel for CO2 sensors                    |
-| `rollershutter`       | rollershutter | No        | This is the channel for rollershutters                 |
-| `rollershutter_slats` | rollershutter | No        | This is the channel for rollershutters with slats      |
-| `thermostat`          | setpoint      | No        | This is the channel for thermostats setpoint           |
-| `thermostat`          | measured      | Yes       | This is the channel for thermostats currenttemp        |
-| `thermostat`          | mode          | No        | This is the channel for thermostats mode               |
+| Thing Type ID         | Channel Name  | Read Only | Description                                              |
+|-----------------------|---------------|-----------|----------------------------------------------------------|
+| `onOff`               | switch        | No        | This is the channel for bistabiel, timers, and intervals |
+| `dimmer`              | brightness    | No        | This is the channel for dimmers 1&2 buttons and CLC      |
+| `scene`               | switch        | No        | This is the channel for scenes                           |
+| `co2`                 | co2           | Yes       | This is the channel for CO2 sensors                      |
+| `rollershutter`       | rollershutter | No        | This is the channel for rollershutters                   |
+| `rollershutter_slats` | rollershutter | No        | This is the channel for rollershutters with slats        |
+| `thermostat`          | setpoint      | No        | This is the channel for thermostat setpoint              |
+| `thermostat`          | measured      | Yes       | This is the channel for thermostat current temperature   |
+| `thermostat`          | mode          | No        | This is the channel for thermostat mode                  |
 
 ## Full Example
 
@@ -99,4 +99,5 @@ Rollershutter       Roller2                     <rollershutter>
 Dimmer              Roller2_slats               <rollershutter>                 ["Blinds"]          {channel="qbus:rollershutter_slats:CTD001122:121:slats"}
 ```
 
-This is the link to the [Qbus forum](https://qbusforum.be). This forum is mainly in dutch and you can find a lot of information about the pre testings of this binding and offers a way to communicate with other users.
+This is the link to the [Qbus forum](<https://qbusforum.be>).
+This forum is mainly in Dutch, and you can find a lot of information about the pre-testings of this binding and offers a way to communicate with other users.

bundles/org.openhab.binding.qbus/src/main/resources/OH-INF/i18n/qbus.properties

@@ -8,65 +8,65 @@ addon.qbus.description = This is the binding for the Qbus home automation system
 thing-type.qbus.bridge.label = Qbus Bridge
 thing-type.qbus.bridge.description = This bridge represents a Qbus client
 thing-type.qbus.co2.label = CO2
-thing-type.qbus.co2.description = Qbus CO2
+thing-type.qbus.co2.description = Qbus CO2 sensor
 thing-type.qbus.dimmer.label = Dimmer
-thing-type.qbus.dimmer.description = Qbus Dimmer Output
+thing-type.qbus.dimmer.description = Qbus dimmer output
 thing-type.qbus.onOff.label = Switch
-thing-type.qbus.onOff.description = Bistabiel-Mono-Timer-Interval Output
+thing-type.qbus.onOff.description = Bistabiel-Mono-Timer-Interval output
 thing-type.qbus.rollershutter.label = RollerShutter
 thing-type.qbus.rollershutter.description = Qbus shutter (ROL02P) control
 thing-type.qbus.rollershutter_slats.label = RollerShutter (With Slats)
 thing-type.qbus.rollershutter_slats.description = Qbus shutter with slats control
 thing-type.qbus.scene.label = Scene
-thing-type.qbus.scene.description = Qbus Scene
+thing-type.qbus.scene.description = Qbus scene
 thing-type.qbus.thermostat.label = Thermostat
-thing-type.qbus.thermostat.description = Qbus Thermostat
+thing-type.qbus.thermostat.description = Qbus thermostat
 
 # thing types config
 
 thing-type.config.qbus.bridge.addr.label = Hostname
-thing-type.config.qbus.bridge.addr.description = IP address or hostname of Qbus server, usually 'localhost'
+thing-type.config.qbus.bridge.addr.description = IP address or hostname of Qbus server, usually localhost
 thing-type.config.qbus.bridge.port.label = Bridge Port
-thing-type.config.qbus.bridge.port.description = Port to communicate with Qbus server, default 8447
+thing-type.config.qbus.bridge.port.description = Port to communicate with Qbus server; default 8447
 thing-type.config.qbus.bridge.serverCheck.label = Server Check
-thing-type.config.qbus.bridge.serverCheck.description = Time to check communication with Qbus Server (min), default 10. If set to 0 or left empty, no refresh will be scheduled
+thing-type.config.qbus.bridge.serverCheck.description = Time to check communication with Qbus Server (min); default 10. If set to 0 or left empty, no refresh will be scheduled
 thing-type.config.qbus.bridge.sn.label = Serial Number
 thing-type.config.qbus.bridge.sn.description = Serial number of the CTD controller
 thing-type.config.qbus.co2.co2Id.label = Qbus CO2 ID
 thing-type.config.qbus.co2.co2Id.description = Qbus CO2 ID
 thing-type.config.qbus.dimmer.dimmerId.label = Output ID
-thing-type.config.qbus.dimmer.dimmerId.description = Qbus Dimmer ID
+thing-type.config.qbus.dimmer.dimmerId.description = Qbus dimmer ID
 thing-type.config.qbus.dimmer.step.label = Step Value
-thing-type.config.qbus.dimmer.step.description = Step value used for increase/decrease of dimmer brightness, default 10%
+thing-type.config.qbus.dimmer.step.description = Step value used for increase/decrease of dimmer brightness; default 10%
 thing-type.config.qbus.onOff.bistabielId.label = Qbus ID
-thing-type.config.qbus.onOff.bistabielId.description = Qbus Bistabiel ID
+thing-type.config.qbus.onOff.bistabielId.description = Qbus bistabiel ID
 thing-type.config.qbus.rollershutter.rolId.label = Rol ID
 thing-type.config.qbus.rollershutter.rolId.description = Qbus Rol Id
 thing-type.config.qbus.rollershutter_slats.rolId.label = Rol ID
 thing-type.config.qbus.rollershutter_slats.rolId.description = Qbus Rol Id
 thing-type.config.qbus.scene.sceneId.label = Qbus Scene ID
-thing-type.config.qbus.scene.sceneId.description = Qbus Scene ID
+thing-type.config.qbus.scene.sceneId.description = Qbus scene ID
 thing-type.config.qbus.thermostat.thermostatId.label = Thermostat ID
-thing-type.config.qbus.thermostat.thermostatId.description = Qbus Thermostat ID
+thing-type.config.qbus.thermostat.thermostatId.description = Qbus thermostat ID
 
 # channel types
 
 channel-type.qbus.co2.label = CO2
 channel-type.qbus.co2.description = CO2 value for Qbus
 channel-type.qbus.measured.label = Measured
-channel-type.qbus.measured.description = Temperature Measured by Thermostat
+channel-type.qbus.measured.description = Temperature measured by thermostat
 channel-type.qbus.mode.label = Mode
-channel-type.qbus.mode.description = Thermostat Mode
+channel-type.qbus.mode.description = Thermostat mode
 channel-type.qbus.mode.state.option.0 = Manual
 channel-type.qbus.mode.state.option.1 = Freeze
 channel-type.qbus.mode.state.option.2 = Economic
 channel-type.qbus.mode.state.option.3 = Comfort
 channel-type.qbus.mode.state.option.4 = Night
 channel-type.qbus.rollershutter.label = Rollershutter
-channel-type.qbus.rollershutter.description = Rollershutter Control for Qbus
+channel-type.qbus.rollershutter.description = Rollershutter control for Qbus
 channel-type.qbus.scene.label = Scene
-channel-type.qbus.scene.description = Scene Control for Qbus
+channel-type.qbus.scene.description = Scene control for Qbus
 channel-type.qbus.setpoint.label = Setpoint
-channel-type.qbus.setpoint.description = Setpoint Temperature of Thermostat
+channel-type.qbus.setpoint.description = Setpoint temperature of thermostat
 channel-type.qbus.slats.label = Slatcontrol
 channel-type.qbus.slats.description = Slatcontrol for Qbus

bundles/org.openhab.binding.qbus/src/main/resources/OH-INF/thing/thing-types.xml

@@ -10,7 +10,7 @@
 		<config-description>
 			<parameter name="addr" type="text" required="true">
 				<label>Hostname</label>
-				<description>IP address or hostname of Qbus server, usually 'localhost'</description>
+				<description>IP address or hostname of Qbus server, usually localhost</description>
 				<default>localhost</default>
 				<context>network-address</context>
 			</parameter>
@@ -20,13 +20,13 @@
 			</parameter>
 			<parameter name="port" type="integer" required="false">
 				<label>Bridge Port</label>
-				<description>Port to communicate with Qbus server, default 8447</description>
+				<description>Port to communicate with Qbus server; default 8447</description>
 				<default>8447</default>
 				<advanced>true</advanced>
 			</parameter>
 			<parameter name="serverCheck" type="integer" required="false" unit="min" min="1">
 				<label>Server Check</label>
-				<description>Time to check communication with Qbus Server (min), default 10. If set to 0 or left empty, no refresh
+				<description>Time to check communication with Qbus Server (min); default 10. If set to 0 or left empty, no refresh
 					will be scheduled</description>
 				<default>10</default>
 				<advanced>true</advanced>
@@ -39,15 +39,15 @@
 			<bridge-type-ref id="bridge"/>
 		</supported-bridge-type-refs>
 		<label>Switch</label>
-		<description>Bistabiel-Mono-Timer-Interval Output</description>
+		<description>Bistabiel-Mono-Timer-Interval output</description>
 		<semantic-equipment-tag>PowerOutlet</semantic-equipment-tag>
 		<channels>
 			<channel id="switch" typeId="system.power"/>
 		</channels>
 		<config-description>
 			<parameter name="bistabielId" type="integer" required="true">
 				<label>Qbus ID</label>
-				<description>Qbus Bistabiel ID</description>
+				<description>Qbus bistabiel ID</description>
 			</parameter>
 		</config-description>
 	</thing-type>
@@ -57,14 +57,14 @@
 			<bridge-type-ref id="bridge"/>
 		</supported-bridge-type-refs>
 		<label>Scene</label>
-		<description>Qbus Scene</description>
+		<description>Qbus scene</description>
 		<channels>
 			<channel id="scene" typeId="scene"/>
 		</channels>
 		<config-description>
 			<parameter name="sceneId" type="integer" required="true">
 				<label>Qbus Scene ID</label>
-				<description>Qbus Scene ID</description>
+				<description>Qbus scene ID</description>
 			</parameter>
 		</config-description>
 	</thing-type>
@@ -74,7 +74,7 @@
 			<bridge-type-ref id="bridge"/>
 		</supported-bridge-type-refs>
 		<label>CO2</label>
-		<description>Qbus CO2</description>
+		<description>Qbus CO2 sensor</description>
 		<semantic-equipment-tag>CO2Sensor</semantic-equipment-tag>
 		<channels>
 			<channel id="co2" typeId="co2"/>
@@ -92,19 +92,19 @@
 			<bridge-type-ref id="bridge"/>
 		</supported-bridge-type-refs>
 		<label>Dimmer</label>
-		<description>Qbus Dimmer Output</description>
+		<description>Qbus dimmer output</description>
 		<semantic-equipment-tag>LightSource</semantic-equipment-tag>
 		<channels>
 			<channel id="brightness" typeId="system.brightness"/>
 		</channels>
 		<config-description>
 			<parameter name="dimmerId" type="integer" required="true">
 				<label>Output ID</label>
-				<description>Qbus Dimmer ID</description>
+				<description>Qbus dimmer ID</description>
 			</parameter>
 			<parameter name="step" type="integer" required="true">
 				<label>Step Value</label>
-				<description>Step value used for increase/decrease of dimmer brightness, default 10%</description>
+				<description>Step value used for increase/decrease of dimmer brightness; default 10%</description>
 				<default>10</default>
 				<advanced>true</advanced>
 			</parameter>
@@ -153,7 +153,7 @@
 			<bridge-type-ref id="bridge"/>
 		</supported-bridge-type-refs>
 		<label>Thermostat</label>
-		<description>Qbus Thermostat</description>
+		<description>Qbus thermostat</description>
 		<semantic-equipment-tag>Thermostat</semantic-equipment-tag>
 		<channels>
 			<channel id="measured" typeId="measured"/>
@@ -163,22 +163,22 @@
 		<config-description>
 			<parameter name="thermostatId" type="integer" required="true">
 				<label>Thermostat ID</label>
-				<description>Qbus Thermostat ID</description>
+				<description>Qbus thermostat ID</description>
 			</parameter>
 		</config-description>
 	</thing-type>
 
 	<channel-type id="scene">
 		<item-type>Switch</item-type>
 		<label>Scene</label>
-		<description>Scene Control for Qbus</description>
+		<description>Scene control for Qbus</description>
 		<category>Scene</category>
 	</channel-type>
 
 	<channel-type id="measured">
 		<item-type>Number:Temperature</item-type>
 		<label>Measured</label>
-		<description>Temperature Measured by Thermostat</description>
+		<description>Temperature measured by thermostat</description>
 		<category>Temperature</category>
 		<tags>
 			<tag>Measurement</tag>
@@ -190,7 +190,7 @@
 	<channel-type id="setpoint">
 		<item-type>Number:Temperature</item-type>
 		<label>Setpoint</label>
-		<description>Setpoint Temperature of Thermostat</description>
+		<description>Setpoint temperature of thermostat</description>
 		<category>Temperature</category>
 		<tags>
 			<tag>Setpoint</tag>
@@ -202,7 +202,7 @@
 	<channel-type id="mode">
 		<item-type>Number</item-type>
 		<label>Mode</label>
-		<description>Thermostat Mode</description>
+		<description>Thermostat mode</description>
 		<category>Number</category>
 		<tags>
 			<tag>Control</tag>
@@ -233,7 +233,7 @@
 	<channel-type id="rollershutter">
 		<item-type>Rollershutter</item-type>
 		<label>Rollershutter</label>
-		<description>Rollershutter Control for Qbus</description>
+		<description>Rollershutter control for Qbus</description>
 		<category>Blinds</category>
 		<tags>
 			<tag>Control</tag>