feat(docs): build all docs at once (#19117)

# Overview

Add to `Makefile` and update `uv` config so you can build the omnibus
docs site.

## Test Plan and Hands on Testing

Tested locally:
- `make -C docs build`
- `make -C docs serve`

Tested CI for this PR and it works.
<img width="2782" height="2002" alt="Screenshot 2025-08-04 at 4 45
04 PM"
src="https://github.com/user-attachments/assets/eb7b06d7-975c-46fa-998c-0a977814a84e"
/>

## Changelog

- Three new `make` commands.
- Add `mkdocs-monorepo-plugin` to requirements.
- Have the CI workflow use the new commands.

## Review requests

Any bad patterns or things we should fix here?
How do we get this using the `sandbox.docs.opentrons.com` domain instead
of a plain S3 URL?

## Risk assessment

low-med, messing with CI.

Author: ecormany

.github/workflows/docs-build-deploy.yaml

@@ -20,7 +20,7 @@ defaults:
     shell: bash
 
 jobs:
-  sandbox-build-and-deploy-flex-manual:
+  sandbox-build-and-deploy-mkdocs-site:
     timeout-minutes: 5
     runs-on: 'ubuntu-24.04'
     permissions:
@@ -45,13 +45,13 @@ jobs:
       - name: Sync the project
         working-directory: ./docs
         run: make setup
-      - name: Build Flex Manual
+      - name: Build Docs Site
         working-directory: ./docs
-        run: make build-flex-manual
-      - name: Deploy Flex Manual to Sandbox
+        run: make build
+      - name: Deploy Docs Site to Sandbox
         working-directory: ./docs
-        run: make deploy-flex-manual BRANCH=${{ env.BRANCH }}
+        run: make deploy BRANCH=${{ env.BRANCH }}
       - name: Output URL to Summary
         run: |
-          echo "## Flex Manual deployed to sandbox" >> $GITHUB_STEP_SUMMARY
-          echo "<http://sandbox.docs.s3-website.us-east-2.amazonaws.com/${{ env.BRANCH }}/flex-manual/>" >> $GITHUB_STEP_SUMMARY
+          echo "## Docs site deployed to sandbox" >> $GITHUB_STEP_SUMMARY
+          echo "<http://sandbox.docs.s3-website.us-east-2.amazonaws.com/${{ env.BRANCH }}/>" >> $GITHUB_STEP_SUMMARY

docs/Makefile

@@ -7,6 +7,21 @@ SANDBOX_S3_BUCKET ?= sandbox.docs
 setup:
 	uv sync
 
+.PHONY: serve
+serve:
+	uv run mkdocs serve -f ./mkdocs.yml
+
+.PHONY: build
+build:
+	uv run mkdocs build -f ./mkdocs.yml
+
+.PHONY: deploy
+deploy:
+	@if [ -n "$$CI" ]; then \
+		echo "If you need to run this locally, set the variable AWS_PROFILE."; \
+	fi
+	aws s3 sync ./site/ s3://$(SANDBOX_S3_BUCKET)/$(BRANCH)/ --acl public-read $(if $(AWS_PROFILE),--profile $(AWS_PROFILE))
+
 .PHONY: serve-flex-manual
 serve-flex-manual:
 	uv run mkdocs serve -f $(FLEX_MANUAL_PREFIX)/mkdocs.yml

docs/pyproject.toml

@@ -8,6 +8,7 @@ dependencies = [
     "mkdocs>=1.6.1",
     "mkdocs-autorefs>=1.4.2",
     "mkdocs-material>=9.6.14",
+    "mkdocs-monorepo-plugin>=1.1.2",
     "mkdocs-parent-css-plugin",
 ]