docs: interim landing page

.github/actions/spelling/expect.txt

@@ -378,8 +378,6 @@ Lato
 lfc
 Lifcycle
 lifecyclekeptnsh
-linecap
-linejoin
 linkedin
 linktitle
 linting
@@ -563,6 +561,7 @@ serrors
 serviceaccount
 serviceaccountspec
 serviceport
+setuptools
 shellcheck
 SHELLFLAGS
 shortcode
@@ -588,7 +587,6 @@ statefultest
 stdouttrace
 storageclasses
 storageversion
-striptags
 sts
 stylesheet
 subchart
@@ -658,6 +656,7 @@ vcluster
 Vec
 versioned
 versioning
+virtualenv
 visualise
 visualised
 vkeptnmetric

.github/workflows/spell-checker.yml

@@ -56,3 +56,4 @@ jobs:
             cspell:software-terms/dict/softwareTerms.txt
             cspell:k8s/dict/k8s.txt
             cspell:golang/dict/go.txt
+            cspell:html/dict/html.txt

.readthedocs.yaml

@@ -9,10 +9,18 @@ version: "2"
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.12"
+    python: "3.11"
+  commands:
+    - python -m virtualenv $READTHEDOCS_VIRTUALENV_PATH
+    - python -m pip install --upgrade --no-cache-dir pip setuptools
+    - python -m pip install --upgrade --no-cache-dir mkdocs
+    - python -m pip install --exists-action=w --no-cache-dir -r requirements.txt
+    - cat mkdocs.yml
+    - python -m mkdocs build --clean --site-dir $READTHEDOCS_OUTPUT/html --config-file mkdocs.yml --strict
 
 mkdocs:
   configuration: mkdocs.yml
+  fail_on_warning: true
 
 python:
   install:

docs-new/Makefile

@@ -25,6 +25,7 @@ docs-build:
 		-v ${PWD}/requirements.txt:/requirements.txt \
 		-v ${PWD}/site:/site \
 		-v ${PWD}/.git:/.git \
+		-v ${PWD}/tmp/.pip-cache:/root/.cache/pip \
 		--entrypoint "" \
 		${MKDOCS_DOCKER_IMAGE}:${MKDOCS_DOCKER_IMAGE_VERSION} \
 		sh -c 'cd /; pip install -r requirements.txt -q; mkdocs build'
@@ -37,9 +38,10 @@ docs-serve:
 		-v ${PWD}/requirements.txt:/requirements.txt \
 		-v ${PWD}/site:/site \
 		-v ${PWD}/.git:/.git \
+		-v ${PWD}/tmp/.pip-cache:/root/.cache/pip \
 		--entrypoint "" \
 		${MKDOCS_DOCKER_IMAGE}:${MKDOCS_DOCKER_IMAGE_VERSION} \
-		sh -c 'cd /; pip install -r requirements.txt -q; mkdocs serve -a 0.0.0.0:$(PORT)'
+		sh -c 'cd /; pip install -r requirements.txt -q; mkdocs serve --dirty -a 0.0.0.0:$(PORT)'
 
 .PHONY: htmltest