Skip to content

Add latest version column to function catalog documentation#1226

Open
aravindtga wants to merge 1 commit intokptdev:mainfrom
Nordix:show-latest-function-version
Open

Add latest version column to function catalog documentation#1226
aravindtga wants to merge 1 commit intokptdev:mainfrom
Nordix:show-latest-function-version

Conversation

@aravindtga
Copy link

Description

This PR adds a "Latest Version" column to the function listing on the catalog documentation site, showing the latest released version for each function with a link to its GitHub release.

Changes

  • documentation/layouts/shortcodes/listfunctions.html
    • Fetch latest release tags per function from the GitHub git/matching-refs API
    • Use numeric semver comparison (major.minor.patch) to determine the latest version, avoiding lexicographic ordering bugs with double-digit versions (e.g., v0.10.0 vs v0.9.0)
  • Documentation updated

Notes

  • The API token is optional. Without it, unauthenticated requests are subject to GitHub's lower rate limits, which may cause version info to be unavailable during builds.
  • For Netlify, set KRM_CATALOG_API_TOKEN via the site's environment variables in the Netlify UI.

Copilot AI review requested due to automatic review settings March 20, 2026 15:44
@aravindtga aravindtga requested a review from efiacor as a code owner March 20, 2026 15:44
@netlify
Copy link

netlify bot commented Mar 20, 2026

Deploy Preview for krm-function-catalog ready!

Name Link
🔨 Latest commit 1a152e6
🔍 Latest deploy log https://app.netlify.com/projects/krm-function-catalog/deploys/69bd7224820a750008ee44b6
😎 Deploy Preview https://deploy-preview-1226--krm-function-catalog.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a “Latest Version” column to the function catalog table by querying GitHub tags per function at build time and linking the displayed version to the corresponding GitHub release.

Changes:

  • Add per-function GitHub API lookups and semver-like selection logic to compute/display latest versions.
  • Add Hugo security.funcs.getenv allowlist entry for KRM_CATALOG_API_TOKEN.
  • Document how to configure an API token for local/Netlify builds and link docs from CONTRIBUTING.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 8 comments.

File Description
documentation/layouts/shortcodes/listfunctions.html Fetches tags from GitHub and renders a new “Latest Version” column with release links
documentation/config.toml Allows reading KRM_CATALOG_API_TOKEN via Hugo security config
documentation/README.md Documents optional GitHub token setup to avoid rate limits
CONTRIBUTING.md Adds pointer to documentation README for running the docs site

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Signed-off-by: Aravindhan Ayyanathan <aravindhan.a@est.tech>
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated no new comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants