Fix doc generation bugs in AppVeyor

Author: natemcmaster

.appveyor.yml

@@ -9,9 +9,7 @@ branches:
     - /^feature\/.*/
 build_script:
   - ps: .\build.ps1 -IsOfficialBuild
-  - ps: .\docs\generate.ps1 -NoBuild
-on_success:
-  - ps: .\docs\push.ps1 -AppVeyor
+  - ps: .\docs\generate.ps1 -NoBuild -Verbose
 environment:
   access_token:
     secure: 7gza5cyC0Fwp5LcFPz9dGMcHXP2jxbrnu7er9R/HkdvnhzGJVADvOtfYO7+Vow5p
@@ -24,6 +22,8 @@ artifacts:
   - path: 'artifacts\*.nupkg'
     name: Packages
     type: NuGetPackages
+after_deploy:
+  - ps: .\docs\push.ps1 -AppVeyor
 deploy:
   - provider: NuGet
     name: myget

docs/.gitattributes

@@ -14,11 +14,11 @@ try {
 
     $buildRoot = "$PSScriptRoot/../.build/docs"
     $targetDir = "$buildRoot/gh-pages"
-    New-Item -ItemType Directory $buildRoot -ErrorAction Ignore
+    mkdir -p $buildRoot -ErrorAction Ignore | Out-Null
 
     if (-not (git worktree list --porcelain | Select-String 'gh-pages')) {
-        & git fetch origin gh-pages
-        & git worktree add $targetDir gh-pages
+        exec git fetch --quiet origin gh-pages:gh-pages
+        exec git worktree add $targetDir gh-pages
     }
 
     $docfxVersion = '2.33.2'
@@ -33,7 +33,7 @@ try {
     }
 
     Push-Location $targetDir
-    & git rm --quiet --force -r .
+    exec git rm --quiet --force -r .
     Pop-Location
 
     if (-not $NoBuild) {
@@ -50,6 +50,7 @@ try {
     finally {
         Push-Location $targetDir
         & git add ./
+        Write-Host "Files that changed in docs:"
         & git --no-pager status -s
         Pop-Location
     }

docs/generate.ps1

@@ -1,7 +1,7 @@
 function exec([string]$_cmd) {
     write-host -ForegroundColor DarkGray ">>> $_cmd $args"
     $ErrorActionPreference = 'Continue'
-    & $_cmd @args
+    & $_cmd @args 2>&1
     $ErrorActionPreference = 'Stop'
     if ($LASTEXITCODE -ne 0) {
         write-error "Failed with exit code $LASTEXITCODE"