make docs helper

Author: lavr

.gitignore

@@ -41,6 +41,7 @@ venv/
 .env
 
 docs/plans/
+docs/_build/
 .claude/*local*
 .claude/worktrees/
 

Makefile

@@ -1,10 +1,22 @@
 
+DOCS_PYTHON = .venv/bin/python
+DOCS_SOURCE = docs
+DOCS_BUILD = $(DOCS_SOURCE)/_build/html
+SPHINXOPTS ?=
+
+.PHONY: clean docs test pypi codeql-db codeql-analyze codeql-clean
+
 clean:
 	find . -name '*.pyc'  -exec rm -f {} \;
 	find . -name '*.py~'  -exec rm -f {} \;
 	find . -name '__pycache__'  -exec rm -rf {} \;
 	find . -name '.coverage.*' -exec rm -rf {} \;
-	rm -rf build dist emails.egg-info tmp-emails _files
+	rm -rf build dist emails.egg-info tmp-emails _files $(DOCS_SOURCE)/_build
+
+docs:
+	$(DOCS_PYTHON) -m sphinx -b html $(SPHINXOPTS) $(DOCS_SOURCE) $(DOCS_BUILD)
+	@echo
+	@echo "Build finished. Open $(DOCS_BUILD)/index.html"
 
 test:
 	tox