Merge branch 'PipeScriptUpdates' of https://github.com/StartAutomating/PipeScript into PipeScriptUpdates

Author: James Brundage

docs/Assert.md

@@ -59,6 +59,22 @@ Invoke-PipeScript {
 } -Verbose
 ```
 
+#### EXAMPLE 5
+```PowerShell
+# assert can be used with the object pipeline.  $_ will be the current object.
+Invoke-PipeScript {
+    1..4 | assert {$_ % 2} "$_ is not odd!"
+} -Debug
+```
+
+#### EXAMPLE 6
+```PowerShell
+# You can provide a ```[ScriptBlock]``` as the second argument to see each failure
+Invoke-PipeScript {
+    1..4 | assert {$_ % 2} { Write-Error "$_ is not odd!" }
+} -Debug
+```
+
 ---
 ### Parameters
 #### **CommandAst**

docs/Inline.YAML.md

@@ -0,0 +1,83 @@
+
+Inline.YAML
+-----------
+### Synopsis
+Yaml File Transpiler.
+
+---
+### Description
+
+Transpiles Yaml with Inline PipeScript into Yaml.
+
+Because Yaml does not support comment blocks, PipeScript can be written inline inside of specialized Yaml string.
+
+PipeScript can be included in a multiline Yaml string with the Key PipeScript and a Value surrounded by {}
+
+---
+### Examples
+#### EXAMPLE 1
+```PowerShell
+{
+    $yamlContent = @'
+PipeScript: |
+{
+@{a='b'}
+}
+```
+List:
+- PipeScript: |
+  {
+    @{a='b';k2='v';k3=@{k='v'}}
+  }
+- PipeScript: |
+  {
+    @(@{a='b'}, @{c='d'})
+  }      
+- PipeScript: |
+  {
+    @{a='b'}, @{c='d'}
+  }
+'@
+    [OutputFile('.\HelloWorld.ps1.yaml')]$yamlContent
+}
+
+.> .\HelloWorld.ps1.yaml
+---
+### Parameters
+#### **CommandInfo**
+
+The command information.  This will include the path to the file.
+
+
+
+|Type          |Requried|Postion|PipelineInput |
+|--------------|--------|-------|--------------|
+|```[Object]```|true    |1      |true (ByValue)|
+---
+#### **Parameter**
+
+A dictionary of parameters.
+
+
+
+|Type               |Requried|Postion|PipelineInput|
+|-------------------|--------|-------|-------------|
+|```[IDictionary]```|false   |2      |false        |
+---
+#### **ArgumentList**
+
+A list of arguments.
+
+
+
+|Type              |Requried|Postion|PipelineInput|
+|------------------|--------|-------|-------------|
+|```[PSObject[]]```|false   |3      |false        |
+---
+### Syntax
+```PowerShell
+Inline.YAML [-CommandInfo] <Object> [[-Parameter] <IDictionary>] [[-ArgumentList] <PSObject[]>] [<CommonParameters>]
+```
+---
+
+