Skip to content

Commit 2423f23

Browse files
committed
docs(build): migrate from Makefile to justfile
why: All other projects in the ecosystem use justfiles for docs builds. The Makefile was the last holdout, creating inconsistency across repos. what: - Replace docs/Makefile with docs/justfile (same recipes, just syntax) - Uses dirhtml builder for clean URLs (matches ecosystem standard) - Update CI workflow to use `just html` instead of `make html` - Update root Makefile doc targets to delegate to justfile - Port 8034 preserved from original Makefile
1 parent f82e7e9 commit 2423f23

4 files changed

Lines changed: 210 additions & 193 deletions

File tree

.github/workflows/docs.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ jobs:
7272
- name: Build documentation
7373
if: env.PUBLISH == 'true'
7474
run: |
75-
pushd docs; make SPHINXBUILD='uv run sphinx-build' html; popd
75+
cd docs && just html
7676
7777
- name: Configure AWS Credentials
7878
if: env.PUBLISH == 'true'

Makefile

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,13 +21,13 @@ watch_test:
2121
if command -v entr > /dev/null; then ${PY_FILES} | entr -c $(MAKE) test; else $(MAKE) test entr_warn; fi
2222

2323
build_docs:
24-
$(MAKE) -C docs html
24+
just -f docs/justfile html
2525

2626
start_docs:
27-
$(MAKE) -C docs start
27+
just -f docs/justfile start
2828

2929
design_docs:
30-
$(MAKE) -C docs design
30+
just -f docs/justfile design
3131

3232
ruff_format:
3333
uv run ruff format .

docs/Makefile

Lines changed: 0 additions & 189 deletions
This file was deleted.

0 commit comments

Comments
 (0)