Versioned docs

Signed-off-by: Daneyon Hansen <[email protected]>

Author: danehans

Makefile

@@ -69,6 +69,10 @@ endif
 # The name of the kind cluster to use for the "kind-load" target.
 KIND_CLUSTER ?= kind
 
+# Docs version variables
+VERSION ?= v0.3.0
+ALIAS   ?= latest
+
 ##@ General
 
 # The help target prints out all targets with their descriptions organized
@@ -275,10 +279,25 @@ build-docs:
 	docker build --pull -t gaie/mkdocs hack/mkdocs/image
 	docker run --rm -v ${PWD}:/docs gaie/mkdocs build
 
-.PHONY: build-docs-netlify
-build-docs-netlify:
-	pip install -r hack/mkdocs/image/requirements.txt
-	python -m mkdocs build
+.PHONY: build-docs-versioned
+build-docs-versioned:
+	@echo "→ Building docs version '$(VERSION)' (alias '$(ALIAS)')…"
+
+	# Install dependencies (mkdocs, plugins, mike, etc.)
+	pip install --user -r hack/mkdocs/image/requirements.txt
+	pip install --user mike
+
+	# Build the static site into 'site/'
+	python -m mkdocs build --site-dir site
+
+	# Determine where pip put the 'mike' script,then invoke versioning explicitly by path
+	USER_BASE := $(shell python3 -m site --user-base)
+	MIKE_BIN  := $(USER_BASE)/bin/mike
+
+	$(MIKE_BIN) deploy --update-aliases $(VERSION) $(ALIAS) site docs
+	$(MIKE_BIN) set-default $(ALIAS) docs
+
+	@echo "Site built in site/, versions written to docs/"
 
 .PHONY: live-docs
 live-docs: