feat: deploy docs from CCI w/ netlify-cli (#3348)

We're just going to accept that docs reflect the entire monorepo,
because:

- needs to make snippets from live code, we don't want that code living
anywhere special, just doc directives where the code lies
- we want to run tsdoc, that needs ~everything because of codegen,
typescript running etc

And netlify CI isn't really meant for this level of complexity. We use
netlify-cli instead.

---------

Co-authored-by: ludamad <adam@aztecprotocol.com>

.circleci/config.yml

@@ -928,6 +928,15 @@ jobs:
       - run:
           name: "Build docs"
           command: build docs
+      - run:
+          name: "Deploy docs"
+          command: |
+            if [ "$CIRCLE_BRANCH" == "master" ]; then
+              echo "Deploying docs (on master)."
+              docs/deploy_netlify.sh
+            else
+              echo "Skipping doc deploy (not on master)."
+            fi
 
   e2e-join:
     docker:

.gitignore

@@ -8,3 +8,6 @@ build/
 cmake-build-debug
 .terraform*
 .bootstrapped
+
+# Local Netlify folder
+.netlify

build_manifest.yml

@@ -173,6 +173,7 @@ docs:
   rebuildPatterns:
     - ^docs/
     - ^.*.cpp$
+    - ^.*.hpp$
     - ^.*.ts$
     - ^.release-please-manifest.json$
     - ^.*/noir-version.json$

docs/.dockerignore

@@ -1,4 +1,4 @@
-*.node_modules
+**/node_modules
 *.docusaurus
 *.processed-docs
 *.processed-docs-cache

docs/Dockerfile.dockerignore

@@ -3,6 +3,7 @@
 *
 
 !docs
+docs/node_modules
 !l1-contracts/src
 !l1-contracts/test
 !barretenberg/cpp/src/barretenberg

docs/deploy_netlify.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+[ -n "${BUILD_SYSTEM_DEBUG:-}" ] && set -x # conditionally trace
+set -eu
+
+extract_repo docs /usr/src extracted-repo
+cd extracted-repo/src/docs
+npm install netlify-cli -g
+netlify deploy --site aztec-docs-dev
+netlify deploy --site aztec-docs-dev --prod