Update docs

Author: ethanhann

docs-src/commands.md

@@ -50,7 +50,9 @@ namespace MyCommandPlugin
 ## Run a Command
 
 Create a class that extends **InEngine.Core.AbstractPlugin** in the same assembly as the command class.
-Add a VerbOptions attribute, from the CommandLine namespace, that defines the name of the command. 
+Add a VerbOptions attribute, from the **CommandLine** namespace, that defines the name of the command. 
+
+This class registers a command in the MyPlugin assembly called "mycommand":
 
 ```c#
 using CommandLine;
@@ -61,7 +63,7 @@ namespace MyCommandPlugin
 {
     public class MyPlugin : AbstractPlugin
     {
-        [VerbOption("my-command", HelpText="My example command.")]
+        [VerbOption("mycommand", HelpText="My example command.")]
         public MyCommand MyCommand { get; set; }
     }
 }
@@ -70,12 +72,12 @@ namespace MyCommandPlugin
 Download the InEngine binary distribution, from the [GitHub Releases](https://github.com/InEngine-NET/InEngine.NET/releases) page, that matches the version of the InEngine.Core package you included.
 
 Copy your project's DLLs into the Plugins subdirectory included in the binary distribution. 
-Add your plugin to the ["Plugins" list in appsettings.config](configuration) at the root of the binary distribution.
+Add your plugin to the "Plugins" list in [appsettings.config](configuration) at the root of the binary distribution.
 
 Run your command:
 
 ```bash
-inengine.exe my-command
+inengine.exe mycommand
 ```
 
 ### Writing Output
@@ -149,29 +151,43 @@ public override void Run()
 
 ### Running non-.NET Commands
 
-It isn't necessary to create C# classes to utilize InEngine.NET.
-Arbitrary commands can be run, with an argument list by leveraging the InEngine.Core plugin's **exec** command.
+It is not necessary to create C# classes to utilize InEngine.NET.
+Arbitrary external programs can be run, with an optional argument list, by leveraging the InEngine.Core plugin's **exec** command.
 
-This command prints the version of python:
+For example, create a python script called **helloworld.py**, make it executable, and add this to it:
 
-```bash
-inengine.exe exec -e"python" -a"--version"
+```python
+#!/usr/bin/env python
+
+print 'Hello, world!'
 ```
 
-Whitelist the "php" command in the [appsettings.json](configuration) file:
+Whitelist the helloworld.py script in the [appsettings.json](configuration) file:
 
 ```json
 {
   "InEngine": {
     // ...
     "ExecWhitelist": {
-      "ls": "ls"
+      "helloworld": "/path/to/helloworld.py"
     }
     // ...
   }
 }
 ```
 
+Now execute it with the **exec** command:
+
+```bash
+inengine exec --executable="helloworld"
+```
+
+If an external executable requires arguments, use the **--args** argument:
+
+```bash
+inengine exec --executable="foo" --args="--version"
+```
+
 ## View Commands
 
 Run inengine.exe with no arguments to see a list of commands:

docs-src/configuration.md

@@ -10,6 +10,14 @@ The **-c, --configuration** argument can also be used to specify an alternate co
     "Plugins": [
       "path/to/MyCommandPlugin"
     ],
+    "ExecWhitelist": {
+      "foo": "/path/to/foo.exe"
+    },
+    "Mail": {
+      "Host": "localhost",
+      "Port": 25,
+      "From": "no-reply@inengine.net"
+    },
     "Queue": {
       "UseCompression": false,
       "PrimaryQueueConsumers":  16,
@@ -29,9 +37,19 @@ The **-c, --configuration** argument can also be used to specify an alternate co
 
 ## Top-level Settings
 
-| Setting                   | Type              | Description                                                                       |
-| ------------------------- | ----------------- | --------------------------------------------------------------------------------- |
-| Plugins                   | array of strings  | A list of paths of plugin assemblies, with ".dll" omitted from the assembly name. |
+| Setting                   | Type              | Description                                                                                                           |
+| ------------------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------- |
+| Plugins                   | array of strings  | A list of paths of plugin assemblies, with ".dll" omitted from the assembly name.                                     |
+| ExecWhitelist             | object            | A set of key/value pairs, where the value is the file system path of an executable and the key is a command alias.    |
+
+
+## Mail Settings
+
+| Setting   | Type      | Description                                           |
+| --------- | --------- | ----------------------------------------------------- |
+| Host      | string    | The hostname of an SMTP server.                       |
+| Port      | integer   | The port of an SMTP server.                           |
+| From      | string    | The default email address used to send email from.    |
 
 
 ## Queue Settings

docs-src/index.md

@@ -52,20 +52,22 @@ inengine.exe queue:consume
 
 There is a special **exec** command in the core plugin that allows for the execution of any program you can run at the command line. 
 
-For example, create a python script called **helloworld.py** that contains this:
+For example, create a python script called **helloworld.py**, make it executable, and add this to it:
 
 ```python
+#!/usr/bin/env python
+
 print 'Hello, world!'
 ```
 
-Whitelist the "python" command in the [appsettings.json](configuration) file:
+Whitelist the "helloworld" executable in the [appsettings.json](configuration) file:
 
 ```json
 {
   "InEngine": {
     // ...
     "ExecWhitelist": {
-      "python": "/usr/bin/python"
+      "helloworld": "/path/to/helloworld.py"
     }
     // ...
   }
@@ -75,7 +77,7 @@ Whitelist the "python" command in the [appsettings.json](configuration) file:
 Now execute it with the **exec** command:
 
 ```bash
-inengine exe --command=python --args=helloworld.py
+inengine exec --executable="helloworld"
 ```
 
 Why would you want to do this?
@@ -84,5 +86,5 @@ It opens up the possibility of running shell scripts, ETLs, Java programs, etc.
 The example python script can be queued:
 
 ```bash
-inengine queue:publish --command-plugin=InEngine.Core --command-verb=exec --args="executable=python" "args=helloworld.py"
+inengine queue:publish --command-plugin=InEngine.Core --command-verb=exec --args="executable=helloworld"
 ```