always deploy the site on push, but only build api docs on release

.gitattributes

@@ -0,0 +1,2 @@
+# suppress diffs and stats for generated api yamls
+Docs/api/** linguist-generated

.github/workflows/web.yml

@@ -35,8 +35,11 @@ jobs:
           dotnet-version: '8.0.x'
       - name: Restore tools
         run: dotnet tool restore
-      - name: Run Document
-        run: dotnet cake --target Document --ref ${{ github.ref }} --buildNum ${{ github.run_number }}
+      - name: Run BuildDocsMetadata
+        if: startsWith(github.ref, 'refs/tags/')
+        run: dotnet cake --target BuildDocsMetadata --ref ${{ github.ref }} --buildNum ${{ github.run_number }}
+      - name: Run BuildDocsSite
+        run: dotnet cake --target BuildDocsSite --ref ${{ github.ref }} --buildNum ${{ github.run_number }}
       - name: Upload docs artifact
         uses: actions/upload-artifact@v4
         with:
@@ -70,7 +73,7 @@ jobs:
           include-hidden-files: true
           if-no-files-found: error
       - name: Deploy
-        if: startsWith(github.ref, 'refs/tags/')
+        if: github.event_name == 'push'
         # this is a beautiful way to deploy a website and i will not take any criticism
         run: |
           curl -L --output cloudflared.deb https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb && sudo dpkg -i cloudflared.deb

Docs/.gitignore

@@ -7,4 +7,3 @@
 /**/bin/
 /**/obj/
 _site
-api