CSHARP-1851: Added ApiDocs task to build.cake.

Author: rstam

Docs/Api/CSharpDriverDocs.shfbproj

@@ -1,6 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003" ToolsVersion="4.0">
   <PropertyGroup>
+    <SHFBROOT Condition=" '$(SHFBROOT)' == '' ">$(MSBuildThisFileDirectory)..\..\packages\EWSoftware.SHFB.2017.1.28.0\Tools\</SHFBROOT>
+    <ComponentPath>$(MSBuildThisFileDirectory)..\..\packages</ComponentPath>
     <!-- The configuration and platform will be used to determine which
          assemblies to include from solution and project documentation
          sources -->

build.cake

@@ -115,6 +115,30 @@ Task("TestLinux")
 Task("Test")
     .IsDependentOn("TestWindows");
 
+Task("ApiDocs")
+    .Does(() =>
+    {
+        var tempDirectory = artifactsDirectory + Directory("tmp");
+        EnsureDirectoryExists(tempDirectory);
+        CleanDirectory(tempDirectory);
+
+        var apiDocsDirectory = solutionDirectory + Directory("Docs") + Directory("Api");
+        var shfbprojFile = apiDocsDirectory + File("CSharpDriverDocs.shfbproj");
+        var preliminary = true;
+        var helpFileVersion = "2.4.4"; // should have build number?
+        MSBuild(shfbprojFile, new MSBuildSettings
+            {
+                Configuration = "Release"
+            }
+            .WithProperty("OutputPath", tempDirectory)
+            .WithProperty("CleanIntermediate", "True")
+            .WithProperty("Preliminary", preliminary ? "True" : "False")
+            .WithProperty("HelpFileVersion", helpFileVersion)
+        );
+
+        // DeleteDirectory(tempDirectory, recursive: true);
+    });
+
 Task("RefDocs")
     .Does(() =>
     {

src/MongoDB.Driver/packages.config

@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <packages>
   <package id="AsyncUsageAnalyzers" version="1.0.0-alpha003" targetFramework="net45" developmentDependency="true" />
+  <package id="EWSoftware.SHFB" version="2017.1.28.0" targetFramework="net45" />
+  <package id="EWSoftware.SHFB.NETFramework" version="4.6.2" targetFramework="net45" />
 </packages>