Complete actions

Author: Ravi Nadahar

concepts/rules.md

@@ -208,7 +208,13 @@ Available types of conditions include:
 The script condition is the most universal one, as you can choose one of the many available script/rule languages to build any condition you can think of.
 The only restriction is a script condition's last executed line of code must result in a boolean (i.e. `true` or `false`).
 
-## Scripts
+## Actions
+
+Once a rule has triggered, and all conditions have been met, the rule will execute one or more actions.
+These are what makes the rule actually _do something_.
+OpenHAB has a set of [standard actions with specific definitions](./standard-actions.md).
+
+### Scripts
 
 Unfortunately the term "Script" is overloaded in openHAB, and has multiple meanings based on the context:
 
@@ -224,7 +230,7 @@ Unfortunately the term "Script" is overloaded in openHAB, and has multiple meani
 
 These rule docs mainly refer to the first two meanings when talking about scripts.
 
-## Script Actions
+### Script Actions
 
 Script Actions are an action that allow you to run logic written in one of the available automation/rule languages, e.g. JavaScript, Rules DSL, Blockly.
 

concepts/standard-actions.md

@@ -42,37 +42,37 @@ This action sends a `Command` to an `Item`.
 
 | Parameter  | Description                                                                             |
 |------------|-----------------------------------------------------------------------------------------|
-| `itemName` | The name of the `Item`.                                                 |
-| `command`  | The `Command` to send. |
+| `itemName` | The name of the `Item`.                                                                 |
+| `command`  | The `Command` to send.                                                                  |
 
 ### `core.ItemStateUpdateAction`
 
 This action updates the `State` of an `Item`.
 
 | Parameter  | Description                                                                             |
 |------------|-----------------------------------------------------------------------------------------|
-| `itemName` | The name of the `Item`.                                                 |
-| `state`    | The `State` to set. |
+| `itemName` | The name of the `Item`.                                                                 |
+| `state`    | The `State` to set.                                                                     |
 
 ### `media.PlayAction`
 
 This action plays an audio file.
 
 | Parameter   | Description                                                                             |
 |-------------|-----------------------------------------------------------------------------------------|
-| `sound`     | The filename of the file from the `sounds` folder. |
-| `[sink]`    | The ID of the audio sink to use. Leave out to use the default. |
-| `[volume]`  | The volume to be used. Leave out to use the default. |
+| `sound`     | The filename of the file from the `sounds` folder.                                      |
+| `[sink]`    | The ID of the audio sink to use. Leave out to use the default.                          |
+| `[volume]`  | The volume to be used. Leave out to use the default.                                    |
 
 ### `media.SayAction`
 
 This action uses the voice system to say the specified text.
 
 | Parameter   | Description                                                                             |
 |-------------|-----------------------------------------------------------------------------------------|
-| `text`      | The text to say. |
-| `[sink]`    | The ID of the voice to use. Leave out to use the default. |
-| `[volume]`  | The volume to be used. Leave out to use the default. |
+| `text`      | The text to say.                                                                        |
+| `[sink]`    | The ID of the voice to use. Leave out to use the default.                               |
+| `[volume]`  | The volume to be used. Leave out to use the default.                                    |
 
 ### `script.ScriptAction`
 
@@ -81,4 +81,4 @@ This action executes the provided script.
 | Parameter | Description                                                             |
 |-----------|-------------------------------------------------------------------------|
 | `type`    | The code/MIME-type for the scripting language.                          |
-| `script`  | The script content to execute.                 |
+| `script`  | The script content to execute.                                          |