fix: Remove all old versions for same major, not just the first match

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: vdusek

.github/workflows/manual_version_docs.yaml

@@ -90,22 +90,25 @@ jobs:
           echo "version=$FULL_VERSION" >> "$GITHUB_OUTPUT"
           echo "Version: $FULL_VERSION, Major.Minor: $MAJOR_MINOR_VERSION, Major: $MAJOR_VERSION"
 
-          # Find the existing version for this major in versions.json (if any).
+          # Find the existing versions for this major in versions.json (if any).
           if [[ -f versions.json ]]; then
-            OLD_VERSION="$(jq -r --arg major "$MAJOR_VERSION" '.[] | select(startswith($major + "."))' versions.json | head -1)"
+            OLD_VERSIONS="$(jq -r --arg major "$MAJOR_VERSION" '.[] | select(startswith($major + "."))' versions.json)"
           else
-            OLD_VERSION=""
+            OLD_VERSIONS=""
             echo "[]" > versions.json
           fi
 
-          # Remove only the specific old version for this major (if found).
-          if [[ -n "$OLD_VERSION" ]]; then
-            echo "Removing old version $OLD_VERSION for major $MAJOR_VERSION"
-            rm -rf "versioned_docs/version-${OLD_VERSION}"
-            rm -f "versioned_sidebars/version-${OLD_VERSION}-sidebars.json"
-            jq --arg old "$OLD_VERSION" '[.[] | select(. != $old)]' versions.json > tmp.json && mv tmp.json versions.json
+          # Remove all old versions for this major (if found).
+          if [[ -n "$OLD_VERSIONS" ]]; then
+            while IFS= read -r OLD_VERSION; do
+              [[ -z "$OLD_VERSION" ]] && continue
+              echo "Removing old version $OLD_VERSION for major $MAJOR_VERSION"
+              rm -rf "versioned_docs/version-${OLD_VERSION}"
+              rm -f "versioned_sidebars/version-${OLD_VERSION}-sidebars.json"
+            done <<< "$OLD_VERSIONS"
+            jq --arg major "$MAJOR_VERSION" 'map(select(startswith($major + ".") | not))' versions.json > tmp.json && mv tmp.json versions.json
           else
-            echo "No existing version found for major $MAJOR_VERSION, nothing to remove"
+            echo "No existing versions found for major $MAJOR_VERSION, nothing to remove"
           fi
 
           # Build API reference and create Docusaurus version snapshots.