implement feedback from #20227

Author: ecormany

.github/workflows/docs-build.yaml

@@ -10,20 +10,22 @@ build:
 
 .PHONY: setup
 setup:
-	uv sync
-	uv pip install -e ../shared-data/
-	uv pip install -e ../api/
-	uv run playwright install --with-deps chromium
+	uv sync --python 3.10 --frozen
+	uv run --python 3.10 playwright install --with-deps chromium
+
+.PHONY: teardown
+teardown:
+	rm -rf .venv
 
 .PHONY: clean
 clean:
 	rm -rf site
 
 .PHONY: serve
 serve:
-	uv run mkdocs serve -f ./mkdocs.yml --livereload
+	uv run --python 3.10 mkdocs serve -f ./mkdocs.yml --livereload
 
 .PHONY: pdf-flex
 pdf-flex:
-	uv run mkdocs build -f ./flex/mkdocs.yml && \
-	uv run python flex/export_to_pdf.py flex/site/print_page/index.html site/Opentrons-Flex-Instruction-Manual.pdf 'Opentrons Flex Instruction Manual'
+	uv run --python 3.10 mkdocs build -f ./flex/mkdocs.yml && \
+	uv run --python 3.10 python flex/export_to_pdf.py flex/site/print_page/index.html site/Opentrons-Flex-Instruction-Manual.pdf 'Opentrons Flex Instruction Manual'

docs/Makefile

@@ -15,7 +15,11 @@ dependencies = [
     "mkdocs-parent-css-plugin",
     "mkdocs-print-site-plugin>=2.8",
     "playwright>=1.55",
+    "opentrons",
+    "opentrons-shared-data",
 ]
 
 [tool.uv.sources]
 mkdocs-parent-css-plugin = { path = "mkdocs-parent-css-plugin", editable = true }
+opentrons-shared-data = { path = "../shared-data", editable = true }
+opentrons = { path = "../api", editable = true }