coalesce publish/docsite jobs (#1077)

* coalesce publish/docsite jobs

* restore branch controls

* remove pull_request trigger on publish

.github/workflows/publish.yml

@@ -54,4 +54,40 @@ jobs:
         with:
           packages-dir: dist
           skip-existing: true
-          verbose: true
+          verbose: true
+  docsite:
+    runs-on: ubuntu-latest
+    needs: [publish, build]
+    if: github.ref=='refs/heads/main' || github.ref=='refs/heads/dev'
+    permissions:
+      id-token: write
+      contents: write
+    steps:
+      - name: Download documentation artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: documentation-site
+          path: docs/documentation-site
+      - name: Publish reference docs (dev branch)
+        uses: peaceiris/actions-gh-pages@v3
+        if: github.ref=='refs/heads/dev'
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs/documentation-site
+          destination_dir: pre-release
+      - name: Publish reference docs (main branch)
+        uses: peaceiris/actions-gh-pages@v3
+        if: github.ref=='refs/heads/main'
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs/documentation-site
+          destination_dir: ${{ needs.publish.outputs.version }}
+      - name: Publish latest reference docs (main branch)
+        uses: peaceiris/actions-gh-pages@v3
+        if: github.ref=='refs/heads/main'
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs/documentation-site
+          destination_dir: latest
+
+