Web api (#201)

When we release a new version of DotPulsar we would like to build the web API and deploy it to GitHub pages.

---------

Co-authored-by: David Jensen <[email protected]>
Co-authored-by: tison <[email protected]>

.asf.yaml

@@ -20,6 +20,8 @@
 github:
   description: "The official .NET client library for Apache Pulsar"
   homepage: https://pulsar.apache.org/
+  ghp_branch:  gh-pages
+  ghp_path:    /docs
   labels:
     - pulsar
     - pubsub
@@ -47,5 +49,4 @@ notifications:
   commits:      [email protected]
   issues:       [email protected]
   pullrequests: [email protected]
-  discussions:  [email protected]
-  jira_options: link label
+  discussions:  [email protected]

.github/workflows/publish-to-nuget.yml

@@ -56,4 +56,31 @@ jobs:
       - name: Publish the package to nuget.org
         run: dotnet nuget push src/DotPulsar/bin/Release/*.nupkg --api-key $NUGET_AUTH_TOKEN --source https://api.nuget.org/v3/index.json
         env:
-          NUGET_AUTH_TOKEN: ${{ secrets.NUGET_KEY }}
+          NUGET_AUTH_TOKEN: ${{ secrets.NUGET_KEY }}
+
+  build-web-api:
+    timeout-minutes: 30
+    needs: build
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+    steps:
+      - name: Check Out
+        uses: actions/checkout@v3
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v3
+        with:
+          dotnet-version: '8.0.x'
+
+      - name: Build docs with docfx
+        run: |
+          dotnet tool update -g docfx
+          dotnet build -p:TargetFramework=net8.0
+          docfx docs/api/docfx.json
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs