add verify docs target

Author: kMutagene

build/Build.fs

@@ -16,6 +16,56 @@ open ReleaseTasks
 
 initializeContext ()
 
+open FSharp.Compiler.Diagnostics
+open BasicTasks
+
+let verifyDocs =
+    BuildTask.create "VerifyDocs" [ clean; build ] {
+        let targets =
+            !! "docs/**.fsx" |> Seq.map (fun f -> f.ToString())
+
+        let checker =
+            FSharp.Compiler.CodeAnalysis.FSharpChecker.Create()
+
+        let ignoredDiagnostics = Set.ofList [ 1182 ] // unused variable
+
+        targets
+        |> Seq.map (fun target ->
+            checker.Compile(
+                [|
+                    "fsc.exe"
+                    "-o"
+                    @"aaaaaaaaaaa.exe"
+                    "-a"
+                    target
+                |]
+            )
+            |> Async.RunSynchronously
+            |> fst
+            |> Seq.where (fun diag ->
+                match diag.Severity with
+                | FSharpDiagnosticSeverity.Error
+                | FSharpDiagnosticSeverity.Warning -> true
+                | _ -> false))
+        |> Seq.collect id
+        |> Seq.where (fun c -> not (ignoredDiagnostics.Contains c.ErrorNumber))
+        |> Seq.sortBy (fun diag ->
+            (match diag.Severity with
+             | FSharpDiagnosticSeverity.Error -> 0
+             | _ -> 1),
+            diag.FileName.[..6 (* to only count the numeric part *) ])
+        |> Seq.map (fun diag ->
+            (match diag.Severity with
+             | FSharpDiagnosticSeverity.Error -> "--- Error: "
+             | _ -> "--- Warning: ")
+            + diag.ToString())
+        |> String.concat "\n"
+        |> (fun errorText ->
+            match errorText with
+            | "" -> ()
+            | text -> raise (System.Exception $"Errors:\n{text}"))
+    }
+
 let sourceFiles =
     !! "src/Plotly.NET/**/*.fs"
     ++ "src/Plotly.NET.ImageExport/**/*.fs"

build/build.fsproj

@@ -27,6 +27,7 @@
     <PackageReference Include="Fake.DotNet.MSBuild" Version="5.22.0" />
     <PackageReference Include="Fake.IO.FileSystem" Version="5.22.0" />
     <PackageReference Include="Fake.Tools.Git" Version="5.22.0" />
+    <PackageReference Include="FSharp.Compiler.Service" Version="41.0.3" />
   </ItemGroup>
 
 </Project>

src/Plotly.NET/Traces/Trace3D.fs

@@ -21,6 +21,14 @@ open System.Runtime.InteropServices
 ///- surface and mesh: 3d surface trace types
 ///- cone and streamtube: 3d vector field trace types
 ///- volume and isosurface: 3d volume trace types
+///- scatter3d, which can be used to draw individual markers, 3d bubble charts and lines and curves
+///- surface and mesh: 3d surface trace types
+///- cone and streamtube: 3d vector field trace types
+///- volume and isosurface: 3d volume trace types
+///- scatter3d, which can be used to draw individual markers, 3d bubble charts and lines and curves
+///- surface and mesh: 3d surface trace types
+///- cone and streamtube: 3d vector field trace types
+///- volume and isosurface: 3d volume trace types
 
 type Trace3D(traceTypeName) =
     inherit Trace(traceTypeName)