Update simple command and resolve remarks

Author: Gijsreyn

docs/reference/resources/Microsoft/DSC/Transitional/RunCommandOnSet/examples/run-a-simple-command.md

@@ -12,14 +12,9 @@ title: Run a simple command
 This example shows how you can use the `Microsoft.DSC.Transitional/RunCommandOnSet` resource to
 execute a simple command during the **Set** operation.
 
-## Test whether the command would run
-
-The following snippet shows how you can use the resource with the [dsc resource test][00] command to check whether
-the command would run.
+## Run the command
 
-> [!NOTE]
-> The `dsc resource test` command performs a synthetic test on this resource. `Microsoft.DSC.Transitional/RunCommandOnSet` doesn't have
-> the `test` capability defined in the [resource manifest][01]
+The following snippet shows how you can invoke the resource to execute a custom command with [dsc resource set][00].
 
 ```powershell
 $instance = @{
@@ -29,35 +24,6 @@ $instance = @{
         'echo Hello world'
     )
 } | ConvertTo-Json
-
-dsc resource test --resource Microsoft.DSC.Transitional/RunCommandOnSet --input $instance
-```
-
-When testing the resource, DSC returns a result indicating the desired state:
-
-```yaml
-desiredState:
-  arguments:
-  - /C
-  - echo Hello world
-  executable: C:\Windows\system32\cmd.exe
-actualState:
-  executable: C:\Windows\system32\cmd.exe
-  arguments:
-  - /C
-  - echo Hello world
-inDesiredState: true
-differingProperties: []
-```
-
-The `inDesiredState` field always returns `true` because of [pretest][02] is supported.
-This means the command is always executed during the **Set** operation.
-
-## Run the command
-
-To execute the command, use the [dsc resource set][03] command.
-
-```powershell
 dsc resource set --resource Microsoft.DSC.Transitional/RunCommandOnSet --input $instance
 ```
 
@@ -84,7 +50,4 @@ changedProperties: []
 > If you want to capture the output, you should redirect it to a file.
 
 <!-- Link reference definitions -->
-[00]: ../../../../../cli/resource/test.md
-[01]: ../../../../../../schemas/resource/manifest/test.md
-[02]: ../../../../../../../reference/cli/resource/set.md
-[03]: ../../../../../cli/resource/set.md
+[00]: ../../../../../cli/resource/set.md

docs/reference/resources/Microsoft/DSC/Transitional/RunCommandOnSet/index.md

@@ -54,7 +54,7 @@ The resource allows you to:
 > [!IMPORTANT]
 > The **Get** operation for this resource does not return any output from the executed command.
 > Additionally, when using the **Test** operation, the resource always reports as being
-> in the desired state.
+> in the desired state. DSC _always_ invokes the command during **Set**.
 
 ## Capabilities
 
@@ -121,7 +121,8 @@ IsWriteOnly       : false
 </details>
 
 Defines the arguments to pass to the executable. Each element in the array represents a
-separate argument that will be passed to the executable.
+separate argument that will be passed to the executable. The arguments are passed
+in the same order that you specify them.
 
 ### exitCode
 
@@ -138,7 +139,7 @@ DefaultValue          : 0
 
 </details>
 
-Defines the expected exit code to indicate success if not zero. By default, an exit code of 0 indicates
+Defines the expected exit code to indicate success if not zero. By default, an exit code of `0` indicates
 successful execution. If your executable returns a different exit code to indicate success, specify that value here.
 
 ## Instance validating schema