Update-PipeScript: Adding -RegionReplacement and Examples (Fixes #179)

Author: StartAutomating

docs/Update-PipeScript.md

@@ -13,6 +13,30 @@ Update-PipeScript is used by PipeScript transpilers in order to make a number of
 
 It can also be used interactively to transform scripts or text in a number of ways.
 
+---
+### Examples
+#### EXAMPLE 1
+```PowerShell
+Update-PipeScript -ScriptBlock {
+    param($x,$y)
+} -RemoveParameter x
+```
+
+#### EXAMPLE 2
+```PowerShell
+Update-PipeScript -RenameVariable @{x='y'} -ScriptBlock {$x}
+```
+
+#### EXAMPLE 3
+```PowerShell
+Update-PipeScript -ScriptBlock {
+    #region MyRegion
+    1
+    #endregion MyRegion
+    2
+} -RegionReplacement @{MyRegion=''}
+```
+
 ---
 ### Parameters
 #### **ScriptBlock**