Issue #106 minor fixes

* typos
* add additional usage description for PUT /things resource

Signed-off-by: Joel Bartelheimer <joel.bartelheimer@bosch.io>

documentation/src/main/resources/openapi/sources/parameters/channelParam.yml

@@ -13,7 +13,8 @@ in: query
 description: |-
   Defines to which channel to route the command: `twin` (digital twin) or `live` (the device).
   * If setting the channel parameter is omitted, the `twin` channel is set by default and the command is routed to the digital representation of a thing in Bosch IoT Things backend.
-  * When using the `live` channel, the command/message is send towards the device.
+  * When using the `live` channel, the command/message is sent towards the device.
 required: false
 schema:
-  type: string
+  type: string
+  enum: [twin, live]

documentation/src/main/resources/openapi/sources/parameters/channelParamPutDescription.yml

@@ -0,0 +1,13 @@
+name: channel
+in: query
+description: |-
+  Defines to which channel to route the command: `twin` (digital twin) or `live` (the device).
+  * If setting the channel parameter is omitted, the `twin` channel is set by default and the command is routed to the digital representation of a thing in Bosch IoT Things backend.
+  * When using the `live` channel, the command/message is sent towards the device.
+
+  The option `live` is not available when a new thing should be created, only for updating an
+  existing thing.
+required: false
+schema:
+  type: string
+  enum: [twin, live]

documentation/src/main/resources/openapi/sources/paths/things/thing.yml

@@ -28,7 +28,7 @@ get:
     - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
     - $ref: '../../parameters/timeoutParam.yml'
     - $ref: '../../parameters/conditionParam.yml'
-    - $ref: '../../parameters/channelParam.yml'
+    - $ref: '../../parameters/channelParamPutDescription.yml'
   responses:
     '200':
       description: The request successfully returned the specific thing.