fix: update GitHub Actions workflow condition and add DocFX build targets to project files, add memberPages

Author: DennisDyallo

.github/workflows/build.yml

@@ -156,7 +156,7 @@ jobs:
     name: Publish to internal NuGet
     runs-on: windows-2019
     needs: build-artifacts
-    if: ${{ github.event.inputs.push-to-dev }}
+    if: ${{ github.event.inputs.push-to-dev == 'true' }}
     permissions:
       contents: read
       packages: write

Yubico.YubiKey/src/Yubico.YubiKey.csproj

@@ -155,4 +155,16 @@ limitations under the License. -->
 
   </ItemGroup>
 
+  <!-- DocFX build target runs after Release-build -->
+  <Target Name="CheckDocFX">
+    <Exec Command="docfx --version" EchoOff="true" ContinueOnError="true" StandardErrorImportance="High" StandardOutputImportance="High">
+      <Output TaskParameter="ExitCode" PropertyName="DocFXExists" />
+    </Exec>
+    <Error Condition="'$(DocFXExists)' != '0'" Text="DocFX is not installed. Please install it using: dotnet tool install --global docfx" />
+  </Target>
+
+  <Target Name="DocFXBuild" AfterTargets="Build" DependsOnTargets="CheckDocFX" Condition="'$(Configuration)' == 'Release'">
+    <Exec Command="docfx build $(MSBuildProjectDirectory)/docfx.json --log docfxlogz.txt" IgnoreExitCode="true"/>
+  </Target>
+
 </Project>

Yubico.YubiKey/src/docfx.json

@@ -7,6 +7,7 @@
       "dest": "../docs/yubikey-api/",
       "disableGitFeatures": true,
       "disableDefaultFilter": false,
+      "memberLayout": "separatePages",
       "filter": "../docs/filterConfig.yml"
     },
     {
@@ -16,6 +17,7 @@
       "dest": "../docs/core-api/",
       "disableGitFeatures": true,
       "disableDefaultFilter": false,
+      "memberLayout": "separatePages",
       "filter": "../docs/filterConfig.yml"
     }
   ],