clean up docs building

.github/workflows/deploy_docs.yml

@@ -9,6 +9,9 @@ on:
       - main
   workflow_dispatch:
 
+env:
+  POETRY_VERSION: "1.7.1"
+
 permissions:
   contents: read
   pages: write
@@ -26,22 +29,17 @@ jobs:
         with:
           fetch-depth: 0
 
+      - name: Set up Python + Poetry ${{ env.POETRY_VERSION }}
+        uses: "./.github/actions/poetry_setup"
+        with:
+          python-version: "3.12"
+          poetry-version: ${{ env.POETRY_VERSION }}
+          cache-key: docs
+
       - name: Install dependencies
         run: |
-          pip install poetry poethepoet
+          poetry install --with docs
 
-      - name: Set up Python
-        uses: actions/setup-python@v4
-        with:
-          python-version: 3.12
-          cache: poetry
-          cache-dependency-path: "libs/langgraph/poetry.lock"
-
-      - name: Poetry install
-        run: |
-          poetry install
-          poetry run pip install -r docs/docs-requirements.txt
-      
       - name: Build site
         run: make build-docs
         env:

.github/workflows/link_check.yml

@@ -46,7 +46,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          poetry install --with dev
+          poetry install --with docs
           poetry run pip install -U pytest pytest-check-links langsmith langchain GitPython
 
       # - name: Check links in notebooks

Makefile

@@ -1,22 +1,16 @@
-.PHONY: all clean format lint test tests test_watch integration_tests docker_tests help extended_tests coverage spell_check spell_fix build-docs serve-docs serve-clean-docs clean-docs
-
-spell_check:
-	poetry run codespell --toml pyproject.toml
-
-spell_fix:
-	poetry run codespell --toml pyproject.toml -w
+.PHONY: build-docs serve-docs serve-clean-docs clean-docs
 
 build-docs:
 	poetry run python docs/_scripts/copy_notebooks.py
-	poetry run mkdocs build --clean -f docs/mkdocs.yml --strict
+	poetry run python -m mkdocs build --clean -f docs/mkdocs.yml --strict
 
 serve-clean-docs: clean-docs
 	poetry run python docs/_scripts/copy_notebooks.py
-	poetry run python -m mkdocs serve -c -f docs/mkdocs.yml --strict -w ./langgraph
+	poetry run python -m mkdocs serve -c -f docs/mkdocs.yml --strict -w ./libs/langgraph
 
 serve-docs:
 	poetry run python docs/_scripts/copy_notebooks.py
-	poetry run python -m mkdocs serve -f docs/mkdocs.yml -w ./langgraph --dirty
+	poetry run python -m mkdocs serve -f docs/mkdocs.yml -w ./libs/langgraph --dirty
 
 clean-docs:
 	find ./docs/docs -name "*.ipynb" -type f -delete

pyproject.toml

@@ -0,0 +1,26 @@
+[tool.poetry]
+name = "langgraph-monorepo"
+version = "0.0.1"
+description = "LangGraph monorepo"
+authors = ["Your Name <you@example.com>"]
+license = "MIT"
+readme = "README.md"
+
+[tool.poetry.dependencies]
+python = "^3.10"
+
+[tool.poetry.group.docs.dependencies]
+langgraph = { path = "libs/langgraph/", develop = true }
+mkdocs = "^1.6.0"
+mkdocstrings = "^0.25.1"
+mkdocstrings-python = "^1.10.4"
+mkdocs-jupyter = "^0.24.7"
+mkdocs-redirects = "^1.2.1"
+mkdocs-minify-plugin = "^0.8.0"
+mkdocs-rss-plugin = "^1.13.1"
+mkdocs-git-committers-plugin-2 = "^2.3.0"
+mkdocs-material = {extras = ["imaging"], version = "^9.5.27"}
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"