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,27 @@
-# 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
+REQS        := requirements.txt
+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 -r $(REQS)
 
-# 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

@@ -1,26 +1,12 @@
-sphinx==6.2.1
-sphinx-argparse==0.4.0
-sphinx-book-theme==1.0.1
-sphinx-copybutton==0.5.2
-sphinx-design==0.6.1
-sphinx-togglebutton==0.3.2
-myst-parser==3.0.1
-msgspec
-cloudpickle
-
-# packages to install to build the documentation
-cachetools
-pydantic >= 2.8
--f https://download.pytorch.org/whl/cpu
-torch
-py-cpuinfo
-transformers
-mistral_common >= 1.5.4
-aiohttp
-sphinx-autodoc2
-starlette
-openai # Required by docs/source/serving/openai_compatible_server.md's vllm.entrypoints.openai.cli_args
-fastapi # Required by docs/source/serving/openai_compatible_server.md's vllm.entrypoints.openai.cli_args
-partial-json-parser # Required by docs/source/serving/openai_compatible_server.md's vllm.entrypoints.openai.cli_args
-requests
-zmq
+markdown
+mike
+mkdocs
+mkdocs-api-autonav
+mkdocs-gen-files
+mkdocs-material
+mkdocs-material[imaging]
+mkdocs-minify-plugin
+mkdocs-nav-weight
+mkdocs-section-index
+mkdocstrings-python
+pymdown-extensions