Using dotnet publish to find refs for docs

.config/dotnet-tools.json

@@ -3,16 +3,16 @@
   "isRoot": true,
   "tools": {
     "fake-cli": {
-      "version": "5.20.0",
+      "version": "5.20.3",
       "commands": [
         "fake"
       ]
     },
     "paket": {
-      "version": "5.245.1",
+      "version": "5.251.0",
       "commands": [
         "paket"
       ]
     }
   }
-}
+}

.github/workflows/build.yml

@@ -7,8 +7,9 @@ jobs:
 
     strategy:
       matrix:
-        os: [ubuntu-latest, windows-latest, macOS-latest]
-        dotnet: [3.1.100]
+        # macOS-latest has issues with always using the latest sdk even when global.json is provided
+        os: [ubuntu-latest, windows-latest]
+        dotnet: [3.1.302]
     runs-on: ${{ matrix.os }}
 
     steps:

Content/Console/.config/dotnet-tools.json

@@ -15,13 +15,13 @@
       ]
     },
     "fake-cli": {
-      "version": "5.20.0",
+      "version": "5.20.3",
       "commands": [
         "fake"
       ]
     },
     "paket": {
-      "version": "5.245.1",
+      "version": "5.251.0",
       "commands": [
         "paket"
       ]
@@ -33,4 +33,4 @@
       ]
     }
   }
-}
+}

Content/Console/.github/workflows/build.yml

@@ -8,7 +8,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, windows-latest, macOS-latest]
-        dotnet: [3.1.100]
+        dotnet: [3.1.302]
     runs-on: ${{ matrix.os }}
 
     steps:

Content/Console/global.json

@@ -0,0 +1,5 @@
+{
+    "sdk": {
+        "version": "3.1.302"
+    }
+}

Content/Console/paket.dependencies

@@ -15,18 +15,18 @@ group Build
     source https://www.nuget.org/api/v2
     source https://api.nuget.org/v3/index.json
     nuget Argu
-    nuget Fake.IO.FileSystem 5.20.0
-    nuget Fake.Core.Target 5.20.0
-    nuget Fake.Core.ReleaseNotes 5.20.0
-    nuget FAKE.Core.Environment 5.20.0
-    nuget Fake.DotNet.Cli 5.20.0
-    nuget FAKE.Core.Process 5.20.0
-    nuget Fake.DotNet.AssemblyInfoFile 5.20.0
-    nuget Fake.Tools.Git 5.20.0
-    nuget Fake.DotNet.Paket 5.20.0
-    nuget Fake.Api.GitHub 5.20.0
-    nuget Fake.BuildServer.AppVeyor 5.20.0
-    nuget Fake.BuildServer.Travis 5.20.0
+    nuget Fake.IO.FileSystem 5.20.3
+    nuget Fake.Core.Target 5.20.3
+    nuget Fake.Core.ReleaseNotes 5.20.3
+    nuget FAKE.Core.Environment 5.20.3
+    nuget Fake.DotNet.Cli 5.20.3
+    nuget FAKE.Core.Process 5.20.3
+    nuget Fake.DotNet.AssemblyInfoFile 5.20.3
+    nuget Fake.Tools.Git 5.20.3
+    nuget Fake.DotNet.Paket 5.20.3
+    nuget Fake.Api.GitHub 5.20.3
+    nuget Fake.BuildServer.AppVeyor 5.20.3
+    nuget Fake.BuildServer.Travis 5.20.3
     nuget Fantomas
 
 group Analyzers

Content/Library/.config/dotnet-tools.json

@@ -15,13 +15,13 @@
       ]
     },
     "fake-cli": {
-      "version": "5.20.0",
+      "version": "5.20.3",
       "commands": [
         "fake"
       ]
     },
     "paket": {
-      "version": "5.245.1",
+      "version": "5.251.0",
       "commands": [
         "paket"
       ]
@@ -39,4 +39,4 @@
       ]
     }
   }
-}
+}

Content/Library/.github/workflows/build.yml

@@ -8,7 +8,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, windows-latest, macOS-latest]
-        dotnet: [3.1.100]
+        dotnet: [3.1.302]
     runs-on: ${{ matrix.os }}
 
     steps:

Content/Library/build.fsx

@@ -626,18 +626,6 @@ let buildDocs _ =
     DocsTool.build ()
 
 let watchDocs _ =
-    let watchBuild () =
-        !! srcGlob
-        |> Seq.map(fun proj -> fun () ->
-            dotnet.watch
-                (fun opt ->
-                    opt |> DotNet.Options.withWorkingDirectory (IO.Path.GetDirectoryName proj))
-                "build"
-                ""
-            |> ignore
-        )
-        |> Seq.iter (invokeAsync >> Async.Catch >> Async.Ignore >> Async.Start)
-    watchBuild ()
     DocsTool.watch ()
 
 let releaseDocs ctx =
@@ -699,13 +687,11 @@ Target.create "ReleaseDocs" releaseDocs
 "UpdateChangelog" ?=> "GenerateAssemblyInfo"
 "UpdateChangelog" ==> "PublishToNuGet"
 
-"DotnetBuild" ==> "BuildDocs"
 "BuildDocs" ==> "ReleaseDocs"
 "BuildDocs" ?=> "PublishToNuget"
 "DotnetPack" ?=> "BuildDocs"
 "GenerateCoverageReport" ?=> "ReleaseDocs"
 
-"DotnetBuild" ==> "WatchDocs"
 
 "DotnetRestore"
     ==> "DotnetBuild"

Content/Library/docsSrc/Tutorials/Getting_Started.md

@@ -1,11 +1,13 @@
 # Getting Started
 
 ```fsharp
+open MyLib._1
 let foo = ()
 let myAge = 21
+let color = Say.FavoriteColor.Red
 ```
 
-## Here is the path to downloading 
+## Here is the path to downloading
 
     [lang=bash]
     paket install MyLib.1

Content/Library/docsSrc/content/style.css

@@ -106,6 +106,7 @@ table.pre td.lines {
 
 body {
   font-family: 'Open Sans', serif;
+  background-color: #BADA55;
 }
 
 pre {

Content/Library/docsTool/Prelude.fs

@@ -9,3 +9,37 @@ module Uri =
         match Uri.TryCreate(url, UriKind.Absolute) with
         | (true, v) -> v
         | _ -> failwithf "Bad url %s" url
+
+
+
+module Diposeable =
+    open System
+    open Fake.Core
+    let dispose (d : #IDisposable) = d.Dispose()
+
+    type DisposableList =
+        {
+            Disposables : IDisposable list
+        } interface IDisposable with
+            member x.Dispose () =
+                x.Disposables |> List.iter(dispose)
+          static member Create(disposables) =
+            {
+                Disposables = disposables
+            } :> IDisposable
+
+    type DisposableDirectory (directory : string) =
+        do
+            Trace.tracefn "Created disposable directory %s" directory
+        static member Create() =
+            let tempPath = IO.Path.Combine(IO.Path.GetTempPath(), Guid.NewGuid().ToString("n"))
+            IO.Directory.CreateDirectory tempPath |> ignore
+
+            new DisposableDirectory(tempPath)
+        member x.Directory = directory
+        member x.DirectoryInfo = IO.DirectoryInfo(directory)
+
+        interface IDisposable with
+            member x.Dispose() =
+                Trace.tracefn "Deleting directory %s" directory
+                IO.Directory.Delete(x.Directory,true)