WiP

Author: IwonaLanger

docs/user/03-60-pass-parameters.md

@@ -8,17 +8,15 @@ To set input parameters, go to the `spec` of the ServiceInstance or ServiceBindi
 
 * **parameters**: Specifies a set of properties sent to the service broker.
   The specified data is passed to the service broker without any modifications - aside from converting it to the JSON format for transmission to the broker if the `spec` field is specified as a YAML file.
-  All valid YAML or JSON constructs are supported.
-
-  > [!NOTE] 
-  > Only one **parameter** field per `spec` can be specified.
+  All valid YAML or JSON constructs are supported. You can specify only one **parameter** field per `spec`.
 
 * **parametersFrom**: Specifies which Secret, together with the key in it, to include in the set of parameters sent to the service broker.
   The key contains a `string` that represents a JSON file. The **parametersFrom** field is a list that supports multiple sources referenced per `spec`.
   The ServiceInstance resource can specify multiple related Secrets.
 
-* **watchParametersFromChanges**: If set to `true`, any changes to the Secret values listed in **parametersFrom** trigger an automatic update of the ServiceInstance resource.
-  By default, the field is set to `false`  and must not be used if **parametersFrom** is empty.
+* **watchParametersFromChanges**: Use this field together with **parametersFrom**.
+  If set to `true`, any changes to the Secret values listed in **parametersFrom** trigger an automatic update of the ServiceInstance resource.
+  By default, the field is set to `false`.
 
 If you specified multiple sources in the **parameters** and **parametersFrom** fields, the final payload merges all of them at the top level.
 

docs/user/resources/02-20-service-instance-cr.md

@@ -39,7 +39,7 @@ The following table lists the parameters of the given resource with their descri
 | **externalName**         | string   | The name for the service instance in SAP BTP; if not specified, defaults to the instance **metadata.name**. |
 | **parameters**           | []object | Some services support the provisioning of additional configuration parameters during the instance creation.<br/>For the list of supported parameters, check the documentation of the particular service offering. |
 | **parametersFrom**       | []object | List of sources from which parameters are populated. |
-| **watchParametersFromChanges** | bool | Must not be used it the **parameterFrom** field is empty. Defaults to `false`.<br>If set to `true`, any changes to the Secret values listed in **parametersFrom** trigger an automatic update of the ServiceInstance resource. |
+| **watchParametersFromChanges** | bool | Defaults to `false`.<br>If set to `true`, any changes to the Secret values listed in **parametersFrom** trigger an automatic update of the ServiceInstance resource. Use this field together with **parameterFrom**. |
 | **customTags**           | []string | List of custom tags describing the service instance; copied to the ServiceBinding Secret in the key called **tags**. |
 | **userInfo**             | object   | The user that last modified this service instance. |
 | **shared**               | *bool    | The shared state. Possible values: `true`, `false`, or none.<br> If not specified, the value defaults to `false`. |