feat: automate cadence release data onto documentation

Author: ibarrajo

README.md

@@ -62,6 +62,11 @@ $ GIT_USER=<Your GitHub username> npm run deploy
 If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
 
 
+### Updating Release Data
+
+The release pages rely on data from GitHub that is persisted as json files under `static/data/releases/`.
+In order to update the release information for display, this can be done manually or be set up as part of the CI/CD process by running the `scripts/fetch-releases.sh` script. Script uses the [GitHub CLI](https://cli.github.com/) to fetch the release data.
+
 # NPM Registry
 
 Ensure you have a `.npmrc` [file](https://docs.npmjs.com/cli/v9/configuring-npm/npmrc/) configured with `registry=https://registry.npmjs.org/`.

docs/09-releases/cadence.mdx

@@ -0,0 +1,29 @@
+---
+layout: default
+title: Cadence Service Releases
+description: Release Notes
+permalink: /docs/releases
+---
+
+import {
+  ListReleases,
+  getReleaseData,
+  getLatestRelease,
+} from "@site/src/components/CadenceReleases";
+
+export const releases = getReleaseData("cadence.json");
+export const latestRelease = getLatestRelease(releases);
+
+Cadence follows [semantic versioning](https://semver.org/spec/v2.0.0.html) and you can find more information about changes between version on the Cadence [changelog](https://github.com/cadence-workflow/cadence/blob/master/CHANGELOG.md).
+
+:::tip[Latest release for General Availability]
+
+  <a href={latestRelease.html_url} target="_blank">{latestRelease.name} ({latestRelease.tag_name}) </a> published on {latestRelease.published_at_date}
+
+:::
+
+<ListReleases releases={releases}></ListReleases>
+
+---
+
+For a comprehensive list of changes and detailed release notes, please visit the [Cadence GitHub Releases page](https://github.com/cadence-workflow/cadence/releases).

docs/09-releases/go-client.mdx

@@ -0,0 +1,27 @@
+---
+layout: default
+title: Cadence Go Client Releases
+description: Release Notes
+permalink: /docs/releases/go-client
+---
+
+# Cadence Go Client
+
+import {ListReleases, getReleaseData, getLatestRelease} from  '@site/src/components/CadenceReleases';
+export const releases = getReleaseData('cadence-go-client.json');
+export const latestRelease = getLatestRelease(releases);
+
+
+Cadence follows [semantic versioning](https://semver.org/spec/v2.0.0.html) and you can find more information about changes between version on the Cadence [changelog](https://github.com/cadence-workflow/cadence/blob/master/CHANGELOG.md).
+
+:::tip[Latest release for General Availability]
+
+<a href={latestRelease.html_url} target="_blank">{latestRelease.name} ({latestRelease.tag_name})</a> published on {latestRelease.published_at_date}
+
+:::
+
+<ListReleases releases={releases}></ListReleases>
+
+---
+
+For a comprehensive list of changes and detailed release notes, please visit the [Cadence GitHub Releases page](https://github.com/cadence-workflow/cadence/releases).

docs/09-releases/java-client.mdx

@@ -0,0 +1,27 @@
+---
+layout: default
+title: Cadence Java Client Releases
+description: Release Notes
+permalink: /docs/releases/java-client
+---
+
+# Cadence Java Client
+
+import {ListReleases, getReleaseData, getLatestRelease} from  '@site/src/components/CadenceReleases';
+export const releases = getReleaseData('cadence-java-client.json');
+export const latestRelease = getLatestRelease(releases);
+
+
+Cadence follows [semantic versioning](https://semver.org/spec/v2.0.0.html) and you can find more information about changes between version on the Cadence [changelog](https://github.com/cadence-workflow/cadence/blob/master/CHANGELOG.md).
+
+:::tip[Latest release for General Availability]
+
+<a href={latestRelease.html_url} target="_blank">{latestRelease.name} ({latestRelease.tag_name})</a> published on {latestRelease.published_at_date}
+
+:::
+
+<ListReleases releases={releases}></ListReleases>
+
+---
+
+For a comprehensive list of changes and detailed release notes, please visit the [Cadence GitHub Releases page](https://github.com/cadence-workflow/cadence/releases).

docs/09-about/01-license.md renamed to docs/10-about/01-license.md

@@ -1,6 +1,6 @@
 {
   "name": "cadence",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",
@@ -26,18 +26,22 @@
     "@docusaurus/preset-classic": "^3.7.0",
     "@docusaurus/remark-plugin-npm2yarn": "^3.7.0",
     "@docusaurus/theme-search-algolia": "^3.7.0",
+    "@iconify/react": "^5.2.0",
     "@mdx-js/react": "^3.0.0",
     "@pnpm/config.env-replace": "^3.0.0",
     "clsx": "^2.0.0",
+    "lodash": "^4.17.21",
     "prism-react-renderer": "^2.3.0",
     "react": "^18.0.0",
     "react-dom": "^18.0.0",
+    "react-markdown": "^9.0.3",
     "remark-math": "^6.0.0"
   },
   "devDependencies": {
     "@docusaurus/module-type-aliases": "^3.7.0",
     "@docusaurus/tsconfig": "^3.7.0",
     "@docusaurus/types": "^3.7.0",
+    "@types/lodash": "^4.17.15",
     "typescript": "~5.6.2"
   },
   "browserslist": {

docs/09-about/index.md renamed to docs/10-about/index.md

@@ -0,0 +1,19 @@
+#!/bin/bash
+# This script downloads the latests release data from cadence-workflow repositories
+
+ gh api \
+  -H "Accept: application/vnd.github+json" \
+  -H "X-GitHub-Api-Version: 2022-11-28" \
+  /repos/cadence-workflow/cadence/releases > static/data/releases/cadence.json
+
+
+ gh api \
+  -H "Accept: application/vnd.github+json" \
+  -H "X-GitHub-Api-Version: 2022-11-28" \
+  /repos/cadence-workflow/cadence-go-client/releases > static/data/releases/cadence-go-client.json
+
+
+ gh api \
+  -H "Accept: application/vnd.github+json" \
+  -H "X-GitHub-Api-Version: 2022-11-28" \
+  /repos/cadence-workflow/cadence-java-client/releases > static/data/releases/cadence-java-client.json

package-lock.json

@@ -143,6 +143,15 @@ const sidebars: SidebarsConfig = {
         { type: 'doc', id: 'workflow-troubleshooting/retries' },
       ],
     },
+    {
+      label: 'Releases',
+      type: 'category',
+      items: [
+        { type: 'doc', 'id': 'releases/cadence', label: 'Cadence Service' },
+        { type: 'doc', 'id': 'releases/go-client', label: 'Cadence Go Client' },
+        { type: 'doc', 'id': 'releases/java-client', label: 'Cadence Java Client' },
+      ],
+    },
     {
       label: 'About',
       type: 'category',