Add latest version column to function catalog documentation

Signed-off-by: Aravindhan Ayyanathan <[email protected]>

Author: aravindtga

CONTRIBUTING.md

@@ -164,6 +164,11 @@ $ go install github.com/monopole/[email protected]
 
 And you need to ensure `$GOPATH/bin` is in your `PATH`.
 
+### Documentation
+
+For details on running the documentation site locally, refer to the
+[documentation README](documentation/README.md).
+
 ### Change Existing Functions
 
 You must follow the layout convention when you make changes to existing

documentation/README.md

@@ -26,6 +26,20 @@ npm install
 Then run the site using `npm run serve`. To have the site run locally with a functioning local search, run
 `npm run serve:with-pagefind`.
 
+## API Token for Version Fetching
+
+The documentation site fetches the latest release versions of KRM functions from
+the GitHub API. To avoid rate limiting, set the `KRM_CATALOG_API_TOKEN`
+environment variable with a GitHub personal access token (no scopes required for
+public repos).
+
+- **Locally:** `export KRM_CATALOG_API_TOKEN=<your-token>` before running `make serve`.
+- **Netlify:** Set `KRM_CATALOG_API_TOKEN` in the site's environment variables via the Netlify UI.
+
+The token is optional. Without it, unauthenticated API requests are subject to
+lower rate limits, which may cause version information to be unavailable during
+builds.
+
 ## License
 
 Licensed under the [Creative Commons Attribution 4.0 International license](LICENSE-documentation)

documentation/config.toml

@@ -190,4 +190,8 @@ enable = false
 [[menu.main]]
   name = "Guides"
   url = "https://kpt.dev/guides/"
-  weight = 40
+  weight = 40
+
+[security]
+  [security.funcs]
+    getenv = ['^HUGO_', '^CI$', '^KRM_CATALOG_API_TOKEN$']

documentation/layouts/shortcodes/listfunctions.html

@@ -3,10 +3,55 @@
 
 {{ $files := readDir $currentDir }}
 
+<!-- Fetch latest version per function using git matching-refs API (one call per function) -->
+{{ $latestVersions := dict }}
+{{ $releaseTags := dict }}
+{{ $token := getenv "KRM_CATALOG_API_TOKEN" }}
+{{ range $files }}
+  {{ if .IsDir }}
+    {{ if ne .Name "examples" }}
+      {{ $fnName := .Name }}
+      {{ $apiURL := printf "https://api.github.com/repos/kptdev/krm-functions-catalog/git/matching-refs/tags/functions/go/%s/v" $fnName }}
+      {{ $opts := cond (ne $token "") (dict "headers" (dict "Authorization" (printf "token %s" $token))) (dict) }}
+      {{ with resources.GetRemote $apiURL $opts }}
+        {{ $refs := . | transform.Unmarshal }}
+        {{ if gt (len $refs) 0 }}
+          {{ $bestRef := "" }}
+          {{ $bestMajor := 0 }}
+          {{ $bestMinor := 0 }}
+          {{ $bestPatch := 0 }}
+          {{ range $refs }}
+            {{ $v := .ref | replaceRE "^.*/v" "" }}
+            {{ $parts := split $v "." }}
+            {{ if ge (len $parts) 3 }}
+              {{ $maj := index $parts 0 | int }}
+              {{ $min := index $parts 1 | int }}
+              {{ $pat := index $parts 2 | int }}
+              {{ if or (gt $maj $bestMajor) (and (eq $maj $bestMajor) (gt $min $bestMinor)) (and (eq $maj $bestMajor) (eq $min $bestMinor) (gt $pat $bestPatch)) }}
+                {{ $bestRef = .ref }}
+                {{ $bestMajor = $maj }}
+                {{ $bestMinor = $min }}
+                {{ $bestPatch = $pat }}
+              {{ end }}
+            {{ end }}
+          {{ end }}
+          {{ if $bestRef }}
+            {{ $tag := $bestRef | replaceRE "^refs/tags/" "" }}
+            {{ $version := $tag | replaceRE "^.*/v" "v" }}
+            {{ $latestVersions = merge $latestVersions (dict $fnName $version) }}
+            {{ $releaseTags = merge $releaseTags (dict $fnName $tag) }}
+          {{ end }}
+        {{ end }}
+      {{ end }}
+    {{ end }}
+  {{ end }}
+{{ end }}
+
 <table class="table table-striped">
 <thead>
   <tr>
     <th>Function</th>
+    <th>Latest Version</th>
     <th>Description</th>
     <th>Tags</th>
   </tr>
@@ -65,6 +110,13 @@
                 <a href="{{ printf "%s/%s/" $functionName $highestVersion }}">{{ .Title }}</a>
               {{ end }}
             </td>
+            <td>
+              {{ $ver := index $latestVersions $functionName }}
+              {{ $tag := index $releaseTags $functionName }}
+              {{ if $ver }}
+                <a href="https://github.com/kptdev/krm-functions-catalog/releases/tag/{{ $tag }}">{{ $ver }}</a>
+              {{ else }}—{{ end }}
+            </td>
             <td>{{ .Params.description | markdownify }}</td>
             <td>
               {{ if .Params.tags }}
@@ -79,6 +131,13 @@
       {{ $title := .Name | replaceRE "\\.[^.]+$" "" }}
       <tr>
         <td><a href="{{ printf "%s" .Name }}">{{ $title }}</a></td>
+        <td>
+          {{ $ver := index $latestVersions .Name }}
+          {{ $tag := index $releaseTags .Name }}
+          {{ if $ver }}
+            <a href="https://github.com/kptdev/krm-functions-catalog/releases/tag/{{ $tag }}">{{ $ver }}</a>
+          {{ else }}—{{ end }}
+        </td>
         <td>No description available</td>
         <td></td>
       </tr>