Small fixes to SubflowRef definition section (#363)

* Small fixes to SubflowRef definition section

Signed-off-by: Tihomir Surdilovic <[email protected]>

* fix typo

Signed-off-by: Tihomir Surdilovic <[email protected]>

* fix typo

Signed-off-by: Tihomir Surdilovic <[email protected]>

Author: tsurdilo

specification.md

@@ -2554,10 +2554,22 @@ to the trigger/produced event.
 
 #### SubFlowRef Definition
 
+`SubFlowRef` definition can have two types, either `string` or `object`.
+If `string`, it defines the unique id of the sub-workflow to be invoked.
+This can be used as a short-cut definition when you want to use the default value of the `waitForCompletion`,
+which is set to `true`:
+
+```json
+"subFlowRef": "mySubFlowId"
+```
+
+If you need to define the `waitForCompletion` property value to `false`, you can use its
+`object` type which has the following properties: 
+
 | Parameter | Description | Type | Required |
 | --- | --- | --- | --- |
-| waitForCompletion | If workflow execution must wait for sub-workflow to finish before continuing (default is `true`) | boolean | yes |
-| workflowId |Sub-workflow unique id | boolean | no |
+| workflowId | Unique id of the sub-workflow to be invoked | boolean | yes |
+| waitForCompletion | If workflow execution must wait for sub-workflow to finish before continuing | boolean | no |
 
 <details><summary><strong>Click to view example definition</strong></summary>
 <p>
@@ -2589,6 +2601,8 @@ workflowId: handleApprovedVisaWorkflowID
 
 </details>
 
+The `workflowId` property defines the unique id of the sub-workflow to be invoked.
+
 The `waitForCompletion` property defines if the SubFlow action should wait until the referenced reusable workflow
 has completed its execution. If it's set to "true" (default value), SubFlow action execution must wait until the referenced workflow has completed its execution.
 In this case the workflow data output of the referenced workflow will be used as the result data of the action.