Feature/Release Notes - Added to Home Page under What's New

.astro/types.d.ts

@@ -325,6 +325,20 @@ declare module 'astro:content' {
   collection: "docs";
   data: InferEntrySchema<"docs">
 } & { render(): Render[".mdx"] };
+"quickstart.mdx": {
+	id: "quickstart.mdx";
+  slug: "quickstart";
+  body: string;
+  collection: "docs";
+  data: InferEntrySchema<"docs">
+} & { render(): Render[".mdx"] };
+"releasenotes.mdx": {
+	id: "releasenotes.mdx";
+  slug: "releasenotes";
+  body: string;
+  collection: "docs";
+  data: InferEntrySchema<"docs">
+} & { render(): Render[".mdx"] };
 "settings/connection.mdx": {
 	id: "settings/connection.mdx";
   slug: "settings/connection";
@@ -353,13 +367,6 @@ declare module 'astro:content' {
   collection: "docs";
   data: InferEntrySchema<"docs">
 } & { render(): Render[".mdx"] };
-"tips/quickstart.mdx": {
-	id: "tips/quickstart.mdx";
-  slug: "tips/quickstart";
-  body: string;
-  collection: "docs";
-  data: InferEntrySchema<"docs">
-} & { render(): Render[".mdx"] };
 "tips/setup.mdx": {
 	id: "tips/setup.mdx";
   slug: "tips/setup";

.env example

@@ -0,0 +1,2 @@
+# Github Token with `public_repo` scope https://github.com/settings/tokens
+API_GITHUB_TOKEN= 

.github/workflows/astro.yml

@@ -65,6 +65,8 @@ jobs:
         run: ${{ steps.detect-package-manager.outputs.manager }} ${{ steps.detect-package-manager.outputs.command }}
         working-directory: ${{ env.BUILD_PATH }}
       - name: Build with Astro
+        env:
+          API_GITHUB_TOKEN: ${{ secrets.API_GITHUB_TOKEN }}
         run: |
           ${{ steps.detect-package-manager.outputs.runner }} astro build \
             --site "${{ steps.pages.outputs.origin }}" \

.gitignore

@@ -2,4 +2,5 @@ node_modules
 .vscode-test/
 *.vsix
 dist
-.DS_Store
+.DS_Store
+.env

package.json

@@ -10,10 +10,12 @@
     "astro": "astro"
   },
   "dependencies": {
+    "@astrojs/check": "^0.5.5",
     "@astrojs/starlight": "^0.19.1",
     "astro": "^4.3.5",
+    "dotenv": "^16.4.5",
+    "marked": "^12.0.0",
     "sharp": "^0.32.5",
-    "@astrojs/check": "^0.5.5",
     "typescript": "^5.3.3"
   }
-}
+}

src/components/ReleaseNotes.astro

@@ -0,0 +1,28 @@
+---
+import { marked } from 'marked';
+import { fetchFromGitHub } from './githubAPI';
+
+// Fetch the releases server-side
+const releases = await fetchFromGitHub('releases');
+
+// Check if releases is defined before trying to parse
+let releasesBodyHtml = [];
+if (releases) {
+    releasesBodyHtml = releases.map((release : any) => {
+        return {
+            name: release.name,
+            body: marked(release.body)
+        };
+    });
+}
+---
+
+{releasesBodyHtml.map((release: any) => (
+    <div>
+        <h2>{release.name}</h2>
+        <div set:html={release.body}></div>
+        <br />
+        <hr />
+        <br />
+    </div>
+))}

src/components/ReleaseVersion.astro

@@ -0,0 +1,14 @@
+---
+import { fetchFromGitHub } from './githubAPI';
+
+// Fetch the latest release server-side
+const release = await fetchFromGitHub('releases/latest');
+
+// Extract the version number
+let version = '';
+if (release) {
+    version = release.tag_name;
+}
+---
+
+{version}

src/components/githubAPI.ts

@@ -0,0 +1,45 @@
+import dotenv from 'dotenv';
+dotenv.config();
+
+// GitHub repository details
+const baseURL = 'https://api.github.com/repos';
+const owner = 'codefori';
+const repo = 'vscode-ibmi';
+const token = process.env.API_GITHUB_TOKEN || '';
+
+/**
+ * Fetch data from GitHub API.
+ *
+ * @param {string} endpoint - The API endpoint to fetch from.
+ * @param {number} limit - The maximum number of items to fetch (default is 5).
+ * @return {Promise<any>} The data from the API, or null if an error occurred.
+ */
+async function fetchFromGitHub(endpoint: string, limit: number = 5) {
+
+    if (!token) {
+        console.error('No GitHub token provided. Setup .env file.');
+        return null;
+    }
+
+    const url = new URL(`${baseURL}/${owner}/${repo}/${endpoint}`);
+    url.searchParams.append('per_page', String(limit));
+
+    const headers = {
+        'Authorization': `token ${token}`,
+        'Accept': 'application/vnd.github.v3+json'
+    };
+    try {
+        const response = await fetch(url.toString(), { headers });
+        if (!response.ok) {
+            console.error(`HTTP error! status: ${response.status}`);
+            return null;
+        }
+        const data = await response.json();
+        return data;
+    } catch (error) {
+        console.error(`Failed to fetch from GitHub: ${error}`);
+        return null;
+    }
+}
+
+export { fetchFromGitHub };

src/content/docs/index.mdx

@@ -3,13 +3,17 @@ title: Code for IBM i
 ---
 
 import { CardGrid, Card, Icon } from '@astrojs/starlight/components';
+import ReleaseVersion from '../../components/ReleaseVersion.astro';
 
-## IBM i development extension for VS Code
+## IBM i development extension for VS Code 
 
 Maintain and compile your RPGLE, CL, COBOL, C/CPP on the IBM i right from Visual Studio Code.
 
 ![intro_01.png](../../assets/intro_01.png)
 
+### What's New in Code for IBM i <ReleaseVersion />
+See our [Release Notes](./releasenotes/) for the latest updates and features.
+
 ## Requirements
 
 - SSH Daemon must be started on IBM i.

src/content/docs/releasenotes.mdx

@@ -0,0 +1,15 @@
+---
+title: Release Notes
+tableOfContents: false
+hero:
+    image:
+        dark: ../../assets/github-mark-white.svg
+        light: ../../assets/github-mark-black.svg
+---
+
+import ReleaseNotes from '../../components/ReleaseNotes.astro';
+import { LinkCard } from '@astrojs/starlight/components';
+
+<ReleaseNotes />
+
+<LinkCard title="Explore More Releases on Github" href="https://github.com/codefori/vscode-ibmi/releases" />