Remove the g

Author: alan-george-lk

.github/workflows/generate-docs.yml

@@ -106,7 +106,7 @@ jobs:
             echo "Version: \`${PROJECT_NUMBER}\`"
             echo ""
             echo "> Note: On a non-tag/release run, the version will resolve to:"
-            echo "  \`<closest tag>-<commits since tag>-g<commit sha>\`"
+            echo "  \`<closest tag>-<commits since tag>-<commit sha>\`"
           } >>"$GITHUB_STEP_SUMMARY"
 
       - name: Verify docs were generated

scripts/generate-docs.sh

@@ -81,6 +81,18 @@ elif [[ -z "$project_number" ]]; then
     described=""
   fi
 
+  # git describe emits "<tag>-<n>-g<sha>[-dirty]" when HEAD is past the
+  # nearest ancestor tag. The leading 'g' on the abbreviated SHA is a
+  # git-describe convention (it once signified the originating SCM back
+  # when SVN/Hg interop mattered) and adds nothing for human readers of
+  # the docs version banner. Strip it so the rendered version reads as
+  # the more obvious "<tag>-<n>-<sha>[-dirty]". Untagged --always
+  # output (bare SHA) and on-tag output (no -<n>-g segment) are left
+  # untouched by this regex.
+  if [[ "$described" =~ ^(.+-[0-9]+)-g([0-9a-f]+)(.*)$ ]]; then
+    described="${BASH_REMATCH[1]}-${BASH_REMATCH[2]}${BASH_REMATCH[3]}"
+  fi
+
   if [[ -z "$described" ]]; then
     project_number="v0.0.0-dev"
   elif [[ "$described" == v* ]]; then