Updates ZipBuildOutput to collect all files. Adds comments to scripts

.github/workflows/docker.yml

@@ -14,6 +14,7 @@ env:
   # solution name does not include extension. .sln is assumed
   SOLUTION_PATH: PepperDash Core
   SOLUTION_FILE: PepperDash Core
+  # ASSEMBLY_FILE
   ASSEMBLY_FILE: PepperDash_Core.dll
   VERSION: 0.0.0-buildtype-buildnumber
   BUILD_TYPE: Debug
@@ -22,10 +23,12 @@ jobs:
   Build_Project:
     runs-on: windows-latest
     steps:
+      # First we checkout the source repo
       - name: Checkout repo
         uses: actions/checkout@v2
         with:
           fetch-depth: 0
+      # And any submodules
       - name: Checkout submodules
         shell: bash
         run: |
@@ -33,38 +36,47 @@ jobs:
           auth_header="$(git config --local --get http.https://github.com/.extraheader)"
           git submodule sync --recursive
           git -c "http.extraheader=$auth_header" -c protocol.version=2 submodule update --init --force --recursive --depth=1
+      # Set the BUILD_TYPE environment variable
       - name: Set Build to Release if triggered from Master
         run: |
           if("$($Env:GITHUB_REF)".contains("$($Env:RELEASE_BRANCH)")) {
             Write-Host "Setting build type to Release"
             Write-Output "::set-env name=BUILD_TYPE::Release"
           }
+      # Fetch all tags
       - name: Fetch tags
         run: git fetch --tags
+      # Generate the appropriate version number  
       - name: Set Version Number
         shell: powershell
         run: |
           $version = ./.github/scripts/GenerateVersionNumber.ps1
           Write-Output "::set-env name=VERSION::$version"
+      # Use the version number to set the version of the assemblies
       - name: Update AssemblyInfo.cs
         shell: powershell
         run: |
           Write-Output ${{ env.VERSION }}
           ./.github/scripts/UpdateAssemblyVersion.ps1 ${{ env.VERSION }}
+      # Build the solutions in the docker image
       - name: Build Solution
         shell: powershell
         run: |
           Invoke-Expression "docker run --rm --mount type=bind,source=""$($Env:GITHUB_WORKSPACE)"",target=""c:/project"" pepperdash/sspbuilder c:\cihelpers\vsidebuild.exe -Solution ""c:\project\$($Env:SOLUTION_PATH)\$($Env:SOLUTION_FILE).sln"" -BuildSolutionConfiguration $($ENV:BUILD_TYPE)"    
+      # Zip up the output files as needed
       - name: Zip Build Output
         shell: powershell
         run: ./.github/scripts/ZipBuildOutput.ps1
+      # Write the version to a file to be consumed by the push jobs
       - name: Write Version
         run: Write-Output "$($Env:VERSION)" | Out-File -FilePath ".\output\version.txt"
+      # Upload the build output as an artifact
       - name: Upload Build Output
         uses: actions/upload-artifact@v1
         with:
           name: Build
           path: ./${{ env.SOLUTION_FILE}}-${{ env.VERSION}}.zip
+      # Upload the Version file as an artifact
       - name: Upload version.txt
         uses: actions/upload-artifact@v1
         with: