diff --git a/docs-site/content/kagent/0.x/resources/versions.md b/docs-site/content/kagent/0.x/resources/versions.md
index 3e304b05..dca44dc6 100644
--- a/docs-site/content/kagent/0.x/resources/versions.md
+++ b/docs-site/content/kagent/0.x/resources/versions.md
@@ -13,7 +13,3 @@ Only the latest kagent release is supported. The tested Kubernetes version above
 The tested version is sourced from `KIND_IMAGE_VERSION` in the [kagent Makefile](https://github.com/kagent-dev/kagent/blob/main/Makefile), which pins the [kindest/node](https://hub.docker.com/r/kindest/node) image used in [CI](https://github.com/kagent-dev/kagent/blob/main/.github/workflows/ci.yaml). CI tests one Kubernetes minor version at a time, not a matrix.
 
 Kubernetes versions other than the one listed above are not tested in CI and are not guaranteed to work, though kagent's Kubernetes client libraries generally follow the [client-go version skew policy](https://github.com/kubernetes/client-go#compatibility-matrix).
-
-<!--TODO
-This page should be updated whenever `KIND_IMAGE_VERSION` changes in the kagent Makefile. The value is sourced from `docs-site/assets/versions/max-kube.md`.
--->
diff --git a/docs-site/content/kagent/1.x/reference/versions.md b/docs-site/content/kagent/1.x/reference/versions.md
index 4faf08a9..9d28378f 100644
--- a/docs-site/content/kagent/1.x/reference/versions.md
+++ b/docs-site/content/kagent/1.x/reference/versions.md
@@ -41,9 +41,6 @@ kagent 1.0 is a deliberate clean break from the 0.10.x line, and the compatibili
 
 Moving from 0.10.x therefore means standing up a new installation and recreating your resources on it, rather than running `helm upgrade`. For the procedure, see [Upgrade from 0.x]({{< link path="operations/upgrade-from-0x#in-place-upgrade-blockers" >}}). For the resources that 1.0 replaces or removes, see [Release notes]({{< link path="reference/release-notes/1.0#removed-and-replaced-resources" >}}).
 
-<!--TODO
-The agent-substrate, kmcp, kagent-tools, and max-kube conrefs are overwritten
-nightly by the update-version-conrefs job in .github/workflows/update-ref-docs.yaml.
-Correct a wrong value in that job, not in the conref, or the next run reverts it.
-kagent.md is the exception and is hand-maintained.
+<!--
+The kagent, agent-substrate, max-kube, kmcp, kmcp-latest, kagent-tools, and runtime-image conrefs are written by .github/workflows/update-ref-docs.yaml from the kagent release tag each time a docs release is published. Correct a wrong value in that workflow, not in the conref, or the next run reverts it. The other conrefs in versions/ are hand-maintained.
 -->