Updating PipeScript.HelpOut.ps1 (including topics, re #132)

Author: StartAutomating

docs/README.ps1.md

@@ -1,17 +1,27 @@
-Files in this directory and it's subdirectories generate wrappers for PipeScript and PowerShell.
-
-These wrappers allow PipeScript or PowerShell to be called from other programming languages.
+This directory and it's subdirectories contain syntax changes that enable common programming scenarios in PowerShell and PipeScript.
 
 ~~~PipeScript{
     [PSCustomObject]@{
         Table = Get-Transpiler -TranspilerPath $pwd |
-            Select-Object DisplayName, @{
-                Name='Synopsis'
-                Expression= { $_.Synopsis -replace '[\s\r\n]+$' }
-            }, @{
+            Select-Object DisplayName, Synopsis, @{
                 Name='Link'
                 Expression = { $_.Name }
             }
-    }
+    }}
+~~~
+
+
+~~~PipeScript{
+    @(foreach ($transpiler in Get-Transpiler -TranspilerPath $pwd) {
+        $examples = @($transpiler.Examples)
+        if (-not $examples) { continue }
+        for ($exampleNumber = 1; $exampleNumber -le $examples.Length; $exampleNumber++) {
+            @("## $($transpiler.DisplayName) Example $($exampleNumber)", 
+                [Environment]::Newline,
+                "~~~PowerShell",                
+                $examples[$exampleNumber - 1],                
+                "~~~") -join [Environment]::Newline
+        }        
+    }) -join ([Environment]::Newline * 2)
 }
-~~~
+~~~