Improved documentation (#20)

* Improve Auto Generated Doc

Signed-off-by: Florian Wagner <florian.wagner@microsoft.com>

* Add images

Signed-off-by: Florian Wagner <florian.wagner@microsoft.com>

Author: Florian Wagner

Deploy/OneClickDeploy.ps1

@@ -30,7 +30,7 @@ After the script is successfully executed the bot should be in a usable state
 None. You cannot pipe objects.
 
 .OUTPUTS
-None
+System.Boolean. Returns $True if executed successfully
 
 #>
 param(
@@ -80,7 +80,7 @@ param(
 $success = $True
 # Import Helper functions
 . "$($MyInvocation.MyCommand.Path -replace($MyInvocation.MyCommand.Name))\HelperFunctions.ps1"
-# Tell who you are (See HelperFunction.ps1)
+# Tell who you are (See HelperFunctions.ps1)
 Write-WhoIAm
 
 # Validate Input parameter combination
@@ -128,4 +128,6 @@ if ($success -eq $False -or $validationresult -eq $False)
     Write-Host -ForegroundColor Red "`n`n# ERROR Occured while execution. Please check your output for errors and rerun the script or scriptlets.`n# Include the '-RERUN `$True' flag in case the execution of script 'DeployInfrastructure.ps1' was already successful."
 } else {
     Write-ExecutionStatus -success $success
-}
+}
+
+exit $success

Doc/CreateMarkdown-FromPS1.ps1

@@ -40,7 +40,7 @@ function Get-ParameterMarkdownTable {
         [object] $help
     )
 
-    $result = "| Name | Type | Required | Default | Description |`n| - | - | - | - | - |"
+    $result = "`n`n## Parameters`n`n| Name | Type | Required | Default | Description |`n| - | - | - | - | - |"
 
     #Write-Host $help
 
@@ -62,7 +62,13 @@ function Get-ParameterMarkdownTable {
         $result += "`n| $($_.name) | $($_.type.name) | $($_.required) | $($default) | $($description) |"
     })
 
-    return $result
+    if ($help.parameters -ne "")
+    {
+        return $result
+    } else {
+        return ""
+    }
+    
 }
 
 function Get-Examples {
@@ -93,6 +99,8 @@ function Get-FlowChart {
     $flowchartfile = "flowchart/$($fileparts[0]).flowchart"
     if (Test-Path -Path $flowchartfile)
     {
+        # Force LF style
+        (Get-Content $flowchartfile -Raw).Replace("`r`n","`n") | Set-Content $flowchartfile -Force
         # render flowchart
         diagrams flowchart $flowchartfile > $null 
 
@@ -101,7 +109,38 @@ function Get-FlowChart {
     } else {
         return ""
     }
+}
+
+function Get-RelatedScripts {
+    param (
+        # PS1 file
+        [Parameter(Mandatory=$True,HelpMessage="PS1 file")]
+        [object] $file
+    )
+
+    $script = Get-Content -Path $file.FullName
+
+    $results = $script | Select-String "([\w]+)\.ps1" -AllMatches
 
+    # Display only Unique values
+    $matches = $results.Matches.Value | Select-Object -uniq
+    # Remove self references
+    $matches = $matches -ne $file.name 
+    # Remove Helper Function references
+    $matches = $matches -ne "HelperFunctions.ps1"
+    $matches = $matches -ne "HelperFunction.ps1"
+    $matches.foreach({
+        $fileparts = $_.Split('.')
+        $related += "`n- [$_]($($fileparts[0]).md)`n"
+    })    
+    
+    #Write-Host $results.Matches
+
+    if ($null -ne $related) {
+        return "`n`n## Related Scripts$related"
+    } else {
+        return ""
+    }
 }
 
 function ConvertHelpToMarkdown {
@@ -129,13 +168,15 @@ function ConvertHelpToMarkdown {
         $markdown += "`n`n## Description`n`n$($help.description.text)"
 
         # Parameters
-        $parameters = Get-ParameterMarkdownTable -help $help
-        $markdown += "`n`n## Parameters`n`n$($parameters)"
+        $markdown += Get-ParameterMarkdownTable -help $help
 
         # Examples
         $examples = Get-Examples -help $help
         $markdown += "`n`n## Examples`n`n$($examples)"
 
+        # Get Related Script
+        $markdown += Get-RelatedScripts -file $file
+
         # flowchart
         $markdown += Get-FlowChart -file $file.name
 

Doc/Deploy/CreateOrImportSSL.md

@@ -47,6 +47,22 @@ After the script is successfully executed the Bot should be in a usable from wit
 ```
 
 
+## Related Scripts
+- [OneClickDeploy.ps1](OneClickDeploy.md)
+
+- [ValidateParameter.ps1](ValidateParameter.md)
+
+- [CheckExistingSSL.ps1](CheckExistingSSL.md)
+
+- [DeactivateSSL.ps1](DeactivateSSL.md)
+
+- [ImportSSL.ps1](ImportSSL.md)
+
+- [CreateSSL.ps1](CreateSSL.md)
+
+- [ActivateSSL.ps1](ActivateSSL.md)
+
+
 ## Flowchart
 
 <div align='center'>

Doc/Deploy/CreateSSL.md

@@ -35,6 +35,10 @@ After the script is successfully executed the certificate should be stored in Ke
 ```
 
 
+## Related Scripts
+- [ActivateSSL.ps1](ActivateSSL.md)
+
+
 ## Flowchart
 
 <div align='center'>

Doc/Deploy/DeactivateSSL.md

@@ -11,11 +11,6 @@ This script will do following steps:
 1. Read relevant data of TrafficManager from Terraform Infrastructure execution
 2. Delete all TrafficManager endpoints, this will also remove the custom domain name entry from WebApps automatically
 
-## Parameters
-
-| Name | Type | Required | Default | Description |
-| - | - | - | - | - |
-
 ## Examples
 
 ```powershell

Doc/Deploy/OneClickDeploy.md

@@ -44,6 +44,20 @@ After the script is successfully executed the bot should be in a usable state
 ```
 
 
+## Related Scripts
+- [ValidateParameter.ps1](ValidateParameter.md)
+
+- [DeployInfrastructure.ps1](DeployInfrastructure.md)
+
+- [DeployLUIS.ps1](DeployLUIS.md)
+
+- [DeployBot.ps1](DeployBot.md)
+
+- [CreateOrImportSSL.ps1](CreateOrImportSSL.md)
+
+- [RetrieveWebChatLink.ps1](RetrieveWebChatLink.md)
+
+
 ## Flowchart
 
 <div align='center'>

Doc/Deploy/OneClickDestroy.md

@@ -34,6 +34,10 @@ After the script is successfully executed there should be nothing left
 ```
 
 
+## Related Scripts
+- [ExportSSL.ps1](ExportSSL.md)
+
+
 ## Flowchart
 
 <div align='center'>

Doc/Deploy/RetrieveWebChatLink.md

@@ -13,11 +13,6 @@ This script will do following steps:
 
 After the script is successfully executed you should have a link to check you bot
 
-## Parameters
-
-| Name | Type | Required | Default | Description |
-| - | - | - | - | - |
-
 ## Examples
 
 ```powershell

Doc/Deploy/ValidateParameter.md

@@ -42,6 +42,10 @@ After the script is successfully executed it should be ensured that the deployme
 ```
 
 
+## Related Scripts
+- [OneClickDeploy.ps1](OneClickDeploy.md)
+
+
 ## Flowchart
 
 <div align='center'>