Consolidated fsdocs into build.yml

Author: 1eyewonder

.github/workflows/build.yml

@@ -38,6 +38,21 @@ jobs:
         env:
           CI: true
 
+      # Upload the static files
+      - name: Upload documentation
+        uses: actions/upload-pages-artifact@v2
+        with:
+          path: ./output
+
+  # GitHub Actions recommends deploying in a separate job.
+  build-docs:
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v2
+
   analyze:
     runs-on: ubuntu-latest
     steps:

.github/workflows/docs.yml

@@ -71,6 +71,8 @@ module dotnet =
 
   let analyzers args = DotNet.exec id "fsharp-analyzers" args
 
+  let fsdocs args = DotNet.exec id "fsdocs" args
+
 let formatCode _ =
   let result = dotnet.fantomas "."
 
@@ -113,6 +115,12 @@ let analyze _ =
 
     result.Errors |> Seq.iter Trace.traceError)
 
+let generateDocs _ =
+  [ "build"; "--properties"; $"Configuration=%s{configuration}" ]
+  |> String.concat " "
+  |> dotnet.fsdocs
+  |> failOnBadExitAndPrint
+
 let clean _ =
   !! "bin" ++ "src/**/bin" ++ "tests/**/bin" ++ "src/**/obj" ++ "tests/**/obj"
   |> Shell.cleanDirs
@@ -258,6 +266,7 @@ let initTargets () =
   Target.create "Test" dotnetTest
   Target.create "CheckFormat" checkFormatCode
   Target.create "Analyze" analyze
+  Target.create "GenerateDocs" generateDocs
   Target.create "AssemblyInfo" generateAssemblyInfo
   Target.create "DotnetPack" dotnetPack
   Target.create "PublishNuget" publishNuget
@@ -276,12 +285,14 @@ let initTargets () =
   // dotnet tools
   "Restore" ==>! "Analyze"
   "Restore" ==>! "CheckFormat"
+  "Build" ==>! "GenerateDocs"
 
   // publishing
   "AssemblyInfo" ==>! "PublishNuGet"
 
   "Clean"
   ==> "CheckFormat"
+  ==> "GenerateDocs"
   ==> "DotnetPack"
   ==> "PublishNuGet"
   ==> "GitRelease"