Combined Haddock Generation (#6146)

.github/workflows/combined-haddock.yml

@@ -1,4 +1,7 @@
-name: Combined Haddock
+# This workflow builds a combined haddock and publishes it to:
+#   https://intersectmbo.github.io/plutus/haddock/master
+#   https://intersectmbo.github.io/plutus/haddock/release/X.X.X.X
+name: "Combined Haddock"
 on:
   workflow_dispatch:
   push:
@@ -13,4 +16,18 @@ jobs:
     environment:
       name: github-pages
     steps:
-      - run: exit 0 
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Build Haddock
+        run: | 
+          nix develop --accept-flake-config --command bash ./scripts/combined-haddock.sh
+
+      - name: Deploy Haddock
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          # This folder is generated in the step above
+          folder: combined_haddock_dst
+          target-folder: haddock/${{ github.ref_name }}
+          # combined_haddock_dst is ~400MB and keeping the entire history is unnecessary.
+          single-commit: true

.gitignore

@@ -99,6 +99,7 @@ node.sock
 .pre-commit-config.yaml
 secrets/*/.gpg-id
 ghcid.txt
+combined_haddock*
 plutus-pab/test-node/testnet/db
 plutus-pab/test-node/alonzo-purple/db
 *.actual.json