Uses mike for live-docs target

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

Author: danehans

.github/workflows/docs-versioning.yml

@@ -0,0 +1,42 @@
+on:
+  push:
+    tags:
+      # 1. Include all semver‐style vX.Y.Z tags
+      - 'v*.*.*'
+      # 2. Exclude anything with "-rc." after the patch
+      - '!v*.*.*-rc.*'
+
+permissions:
+  contents: write
+
+jobs:
+  version-docs:
+    runs-on: ubuntu-latest
+    env:
+      VERSION: ${{ github.ref_name }}   # picks up the tag, e.g. v0.3.0
+      ALIAS: latest                     # your “latest” alias
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0                # ensures tags are available
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+      - name: Install dependencies
+        run: pip install mkdocs mike
+      - name: Build MkDocs site
+        run: mkdocs build --site-dir site
+      - name: Version with mike
+        run: |
+          mike deploy \
+            --branch main \
+            --push \
+            --update-aliases $VERSION $ALIAS \
+            site docs
+          mike set-default \
+            --branch main \
+            --push \
+            $ALIAS docs
+      - name: Push versioned docs
+        run: git push origin main

Makefile

@@ -275,15 +275,14 @@ 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: live-docs
 live-docs:
-	docker build -t gaie/mkdocs hack/mkdocs/image
-	docker run --rm -it -p 3000:3000 -v ${PWD}:/docs gaie/mkdocs
+	docker build --pull -t gaie/mkdocs hack/mkdocs/image
+	docker run --rm -it \
+	  -p 3000:3000 \
+	  -e DEV_ADDR="0.0.0.0:3000" \
+	  -v ${PWD}:/docs:rw \
+	  gaie/mkdocs
 
 .PHONY: api-ref-docs
 api-ref-docs: