just use simpleexec to build the docs

Author: thefringeninja

Dockerfile

@@ -6,7 +6,7 @@ ARG TRAVIS_PULL_REQUEST
 ARG TRAVIS_BRANCH
 ARG MYGET_API_KEY
 
-RUN apk add nodejs --no-cache git
+RUN apk add nodejs yarn --no-cache
 
 WORKDIR /src
 
@@ -20,6 +20,10 @@ RUN dotnet restore --runtime=alpine.3.7-x64
 
 COPY ./src .
 
+WORKDIR /docs
+
+COPY ./docs/package.json ./docs/yarn.lock ./
+
 WORKDIR /build
 
 COPY ./build/build.csproj .
@@ -28,12 +32,6 @@ RUN dotnet restore
 
 COPY ./build .
 
-WORKDIR /docs
-
-COPY ./docs/* ./
-
-RUN dotnet restore
-
 WORKDIR /
 
 RUN TRAVIS_BUILD_NUMBER=$TRAVIS_BUILD_NUMBER \

build/Program.cs

@@ -1,5 +1,8 @@
 using System;
 using System.IO;
+using System.Linq;
+using System.Runtime.InteropServices;
+using System.Threading.Tasks;
 using static Bullseye.Targets;
 using static SimpleExec.Command;
 
@@ -29,16 +32,45 @@ public static void Main(string[] args)
                 Directory.Delete(ArtifactsDir, true);
             }
         });
-        
+
         Target(
             GenerateDocumentation,
-            () => Run("dotnet", "build docs/docs.csproj --verbosity normal"));
+            () =>
+            {
+                var srcDirectory = new DirectoryInfo("./src");
+
+                var schemaFiles = srcDirectory.GetFiles("*.schema.json", SearchOption.AllDirectories);
+
+                var schemaDirectories = schemaFiles
+                    .Select(schemaFile => schemaFile.DirectoryName)
+                    .Distinct()
+                    .Select(schemaDirectory =>
+                        schemaDirectory.Replace(Path.DirectorySeparatorChar,
+                            '/')); // normalize paths; yarn/node can handle forward slashes
+
+                if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
+                {
+                    Run("cmd", "/c yarn", "docs");
+                }
+                else
+                {
+                    Run("yarn", string.Empty, "docs");
+                }
+
+                foreach (var schemaDirectory in schemaDirectories)
+                {
+                    Run(
+                        "node",
+                        $"node_modules/@adobe/jsonschema2md/cli.js -n --input {schemaDirectory} --out {schemaDirectory} --schema-out=-",
+                        "docs");
+                }
+            });
 
         Target(
-            Build, 
+            Build,
             DependsOn(GenerateDocumentation),
             () => Run(
-                "dotnet", 
+                "dotnet",
                 $"build src/SqlStreamStore.HAL.sln -c Release /p:BuildMetadata={buildMetadata}"));
 
         Target(
@@ -50,24 +82,25 @@ public static void Main(string[] args)
 
         Target(
             Pack,
-            DependsOn(Build), 
+            DependsOn(Build),
             () => Run(
                 "dotnet",
                 $"pack src/SqlStreamStore.HAL -c Release -o ../../{ArtifactsDir} --no-build"));
 
         Target(
-            Publish, 
-            DependsOn(Pack), 
-            () => {
+            Publish,
+            DependsOn(Pack),
+            () =>
+            {
                 var packagesToPush = Directory.GetFiles(ArtifactsDir, "*.nupkg", SearchOption.TopDirectoryOnly);
                 Console.WriteLine($"Found packages to publish: {string.Join("; ", packagesToPush)}");
-    
+
                 if (string.IsNullOrWhiteSpace(apiKey))
                 {
                     Console.WriteLine("MyGet API key not available. Packages will not be pushed.");
                     return;
                 }
-    
+
                 foreach (var packageToPush in packagesToPush)
                 {
                     Run(
@@ -83,15 +116,15 @@ public static void Main(string[] args)
 
     private static string GetBranch()
         => (Environment.GetEnvironmentVariable("TRAVIS_PULL_REQUEST")?.ToLower() == "false"
-                ? null
-                : $"pr-{Environment.GetEnvironmentVariable("TRAVIS_PULL_REQUEST")}")
-            ?? Environment.GetEnvironmentVariable("TRAVIS_BRANCH") 
-            ?? "none";
+               ? null
+               : $"pr-{Environment.GetEnvironmentVariable("TRAVIS_PULL_REQUEST")}")
+           ?? Environment.GetEnvironmentVariable("TRAVIS_BRANCH")
+           ?? "none";
 
-    private static string GetCommitHash() 
+    private static string GetCommitHash()
         => Environment.GetEnvironmentVariable("TRAVIS_PULL_REQUEST_SHA")
-            ?? Environment.GetEnvironmentVariable("TRAVIS_COMMIT")
-            ?? "none";
+           ?? Environment.GetEnvironmentVariable("TRAVIS_COMMIT")
+           ?? "none";
 
     private static string GetBuildNumber()
         => (Environment.GetEnvironmentVariable("TRAVIS_BUILD_NUMBER") ?? "0").PadLeft(5, '0');