FIXUP

Author: daviwil

scripts/BuildDocs.ps1

@@ -1,10 +1,11 @@
-param([switch]$Serve)
+param([switch]$Serve, [switch]$Clean)
 
 $toolsPath = [System.IO.Path]::GetFullPath("$PSScriptRoot\..\tools")
 $docfxZipPath = [System.IO.Path]::GetFullPath("$toolsPath\docfx.zip")
 $docfxBinPath = [System.IO.Path]::GetFullPath("$toolsPath\docfx\")
 $docfxExePath = [System.IO.Path]::GetFullPath("$docfxBinPath\docfx.exe")
 $docfxJsonPath = [System.IO.Path]::GetFullPath("$PSScriptRoot\..\docs\docfx.json")
+$sitePath = [System.IO.Path]::GetFullPath("$PSScriptRoot\..\docs\_site")
 
 # Ensure the tools path exists
 mkdir $toolsPath -Force | Out-Null
@@ -18,12 +19,17 @@ if (![System.IO.File]::Exists($docfxExePath)) {
     Expand-Archive $docfxZipPath -DestinationPath $docfxBinPath -Force -ErrorAction "Stop"
 }
 
+# Clean the _site folder if necessary
+if ($Clean.IsPresent) {
+    Remove-Item -Path $sitePath -Force -Recurse -Confirm | Out-Null
+}
+
 # Build the metadata for the C# API
-& $docfxExepath metadata $docfxJsonPath
+& $docfxExePath metadata $docfxJsonPath
 
 if ($Serve.IsPresent) {
-    & $docfxExepath build $docfxJsonPath --serve
+    & $docfxExePath build $docfxJsonPath --serve
 }
 else {
-    & $docfxExepath build $docfxBinPath
+    & $docfxExePath build $docfxJsonPath
 }