add back

Author: kevinjqliu

.github/workflows/python-ci-docs.yml

@@ -41,6 +41,8 @@ jobs:
           python-version: 3.12
       - name: Install UV
         uses: astral-sh/setup-uv@v7
+      - name: Install
+        run: make docs-install
       - name: Build docs
         run: make docs-build
       - name: Run linters

.github/workflows/python-release-docs.yml

@@ -36,6 +36,8 @@ jobs:
           python-version: ${{ matrix.python }}
       - name: Install UV
         uses: astral-sh/setup-uv@v7
+      - name: Install docs
+        run: make docs-install
       - name: Build docs
         run: make docs-build
       - name: Copy

Makefile

@@ -98,7 +98,7 @@ test: ## Run all unit tests (excluding integration)
 
 test-integration: test-integration-setup test-integration-exec test-integration-cleanup ## Run integration tests
 
-test-integration-setup: ## Start Docker services for integration tests
+test-integration-setup: install ## Start Docker services for integration tests
 	docker compose -f dev/docker-compose-integration.yml kill
 	docker compose -f dev/docker-compose-integration.yml rm -f
 	docker compose -f dev/docker-compose-integration.yml up -d --build --wait
@@ -145,23 +145,29 @@ coverage-report: ## Combine and report coverage
 
 ##@ Documentation
 
+docs-install: ## Install docs dependencies (included in default groups)
+	uv sync $(PYTHON_ARG) --group docs
+
 docs-serve: ## Serve local docs preview (hot reload)
-	uv run $(PYTHON_ARG) --group docs mkdocs serve -f mkdocs/mkdocs.yml --livereload
+	uv run $(PYTHON_ARG) mkdocs serve -f mkdocs/mkdocs.yml --livereload
 
 docs-build: ## Build the static documentation site
-	uv run $(PYTHON_ARG) --group docs mkdocs build -f mkdocs/mkdocs.yml --strict
+	uv run $(PYTHON_ARG) mkdocs build -f mkdocs/mkdocs.yml --strict
 
 # ========================
 # Experimentation
 # ========================
 
 ##@ Experimentation
 
-notebook: ## Launch notebook for experimentation
-	uv run $(PYTHON_ARG) --all-extras --group notebook jupyter lab --notebook-dir=notebooks
+notebook-install: ## Install notebook dependencies
+	uv sync $(PYTHON_ARG) --all-extras --group notebook
+
+notebook: notebook-install ## Launch notebook for experimentation
+	uv run jupyter lab --notebook-dir=notebooks
 
-notebook-infra: test-integration-setup ## Launch notebook with integration test infra (Spark, Iceberg Rest Catalog, object storage, etc.)
-	uv run $(PYTHON_ARG) --all-extras --group notebook jupyter lab --notebook-dir=notebooks
+notebook-infra: notebook-install test-integration-setup ## Launch notebook with integration test infra (Spark, Iceberg Rest Catalog, object storage, etc.)
+	uv run jupyter lab --notebook-dir=notebooks
 
 # ===================
 # Project Maintenance

mkdocs/README.md

@@ -22,5 +22,6 @@ The pyiceberg docs are stored in `docs/`.
 ## Running docs locally
 
 ```sh
+make docs-install
 make docs-serve
 ```