From d65b859a8fab1514cf4d2e68fd411604d631db05 Mon Sep 17 00:00:00 2001
From: Chris Wolfgang <210299580+Chris-Wolfgang@users.noreply.github.com>
Date: Fri, 24 Jul 2026 16:25:45 -0400
Subject: [PATCH] fix(version-picker): correct comment about auto-select
 behavior

---
 docfx_project/public/version-picker.js | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/docfx_project/public/version-picker.js b/docfx_project/public/version-picker.js
index e1fb319..af3010e 100644
--- a/docfx_project/public/version-picker.js
+++ b/docfx_project/public/version-picker.js
@@ -94,9 +94,11 @@
             // on /versions/latest/. On every other page the highest-
             // numbered v* entry already represents the latest release
             // and surfacing both is redundant; on /versions/latest/ we
-            // NEED `latest` in the list because otherwise the picker
-            // would show no selected option and the reader would have
-            // no way to know which version they are viewing.
+            // NEED `latest` in the list because without it the browser auto-
+            // selects the first concrete version (whichever v* is top of
+            // the list), and choosing that same value doesn't fire
+            // `change`, so the reader can't navigate away to the
+            // concrete-version URL.
             if (v.version === 'latest' && currentVersion !== 'latest') return;
             var opt = document.createElement('option');
             opt.value = v.url;