clean up Mark's initial docs work

Author: aireilly

.gitignore

@@ -56,6 +56,7 @@ wheels/
 *.egg
 MANIFEST
 .cache/*
+docs/.cache/*
 
 # PyInstaller
 #  Usually these files are written by a python script from a template

.readthedocs.yaml

@@ -1,50 +1,26 @@
-# Minimal makefile for Sphinx documentation
+# Minimal mkdocs makefile
 
-# You can set these variables from the command line, and also
-# from the environment for the first two.
-SPHINXOPTS    ?=
-SPHINXBUILD   ?= sphinx-build
-SOURCEDIR     = source
-BUILDDIR      = build
+PYTHON      := python3
+MKDOCS_CMD  := mkdocs
+MKDOCS_CONF := ../mkdocs.yml
 
-EXAMPLES_SRC  = ../examples
-EXAMPLES_DST  = $(SOURCEDIR)/doc
+.PHONY: help install serve build clean
 
-.PHONY: help Makefile clean update-examples html
-
-# Default target
 help:
-	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@echo "Available targets:"
+	@echo "  install  Install dependencies globally"
+	@echo "  serve    Serve docs locally"
+	@echo "  build    Build static site"
+	@echo "  clean    Remove build artifacts"
 
-# Clean build and copied example files
-clean:
-	@$(SPHINXBUILD) -M clean "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
-	rm -rf $(EXAMPLES_DST)
+install:
+	pip install -e "../[dev]"
 
-# Copies .md files from ../examples/ to source/doc/, and updates docs/examples.md
-update-examples:
-	rm -rf $(EXAMPLES_DST)
-	mkdir -p $(EXAMPLES_DST)
-	DOCS_ROOT=$$(pwd); \
-	cd $(EXAMPLES_SRC) && find . -name '*.md' -type f -exec sh -c ' \
-		DOCS_ROOT="'"$$DOCS_ROOT"'"; \
-		EXAMPLES_DST="'"$(EXAMPLES_DST)"'"; \
-		for f; do \
-			mkdir -p "$$DOCS_ROOT/$$EXAMPLES_DST/$$(dirname "$$f")"; \
-			cp "$$f" "$$DOCS_ROOT/$$EXAMPLES_DST/$$f"; \
-		done' sh {} +
-	@echo "Generating source/examples.md..."
-	@./scripts/copy-example-docs.sh
+serve:
+	$(MKDOCS_CMD) serve --livereload -f $(MKDOCS_CONF)
 
-# Build docs and optionally serve locally
-html: clean update-examples
-	@$(SPHINXBUILD) -M html "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
-	@if [ -z "$$CI" ]; then \
-		echo "Starting local HTTP server at http://localhost:8000"; \
-		python3 -m http.server --directory $(BUILDDIR)/html; \
-	fi
+build:
+	$(MKDOCS_CMD) build -f $(MKDOCS_CONF)
 
-# Catch-all target: route all unknown targets to Sphinx using the new
-# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
-%: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+clean:
+	rm -rf site/ .cache/

docs/Makefile

@@ -9,7 +9,7 @@ cd docs
 - Install the dependencies:
 
 ```bash
-pip install -r docs/requirements.txt
+make install
 ```
 
 - Clean the previous build (optional but recommended):
@@ -18,16 +18,11 @@ pip install -r docs/requirements.txt
 make clean
 ```
 
-- Generate the HTML documentation:
+- Serve the docs:
 
 ```bash
-make html
+make serve
 ```
 
 This will start a local server at http://localhost:8000. You can now open your browser and view the documentation.
 
-If port 8000 is already in use, you can specify a different port, for example:
-
-```bash
-python -m http.server 3000 -d build/html/
-```