Versioned docs

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

Author: danehans

Makefile

@@ -270,15 +270,33 @@ bbr-image-kind: bbr-image-build ## Build the image and load it to kind cluster $
 
 ##@ Docs
 
+VERSION ?= v0.3.0
+ALIAS   ?= latest
+
+# Compute where pip --user installs scripts
+USER_BASE := $(shell python3 -m site --user-base)
+MIKE_BIN  := $(USER_BASE)/bin/mike
+
 .PHONY: build-docs
 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
+
+	$(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: