From b6a8a67803a51699ec0d585bc884eb240405cd28 Mon Sep 17 00:00:00 2001
From: Paul Gaikwad <gaikwadpaul05@gmail.com>
Date: Fri, 17 Oct 2025 01:30:33 +0200
Subject: [PATCH 01/10] Added Dynamic Fetching Feature. Removed earlier static
 fetching

---
 _data/sidebars/community_sidebar.yaml         |   5 +-
 _data/sidebars/docs_sidebar.yml               |   7 +-
 content/docs/fundamentals/fundamentals-faq.md | 140 ++++++++++++++++++
 tools/forum-proxy.js                          |  55 +++++++
 4 files changed, 203 insertions(+), 4 deletions(-)
 create mode 100644 content/docs/fundamentals/fundamentals-faq.md
 create mode 100644 tools/forum-proxy.js

diff --git a/_data/sidebars/community_sidebar.yaml b/_data/sidebars/community_sidebar.yaml
index 636e7fd5df8..135cd9931b9 100644
--- a/_data/sidebars/community_sidebar.yaml
+++ b/_data/sidebars/community_sidebar.yaml
@@ -118,11 +118,10 @@ entries:
     - title: Example - OpenFOAM adapter
       url: /community-guidelines-adapters-openfoam.html
       output: web
-    
+  
+
   - title: Community channels
     url: /community-channels.html
     output: web
-
-
     
 
diff --git a/_data/sidebars/docs_sidebar.yml b/_data/sidebars/docs_sidebar.yml
index 9f784b47c94..32d9b2238c4 100644
--- a/_data/sidebars/docs_sidebar.yml
+++ b/_data/sidebars/docs_sidebar.yml
@@ -43,7 +43,12 @@ entries:
     - title: Roadmap
       url: /fundamentals-roadmap.html
       output: web, pdf
-    
+
+    - title: FAQ
+      url: /fundamentals-faq.html
+      output: web, pdf
+      tags: faq
+
     - title: Previous versions
       url: /fundamentals-previous-versions.html
       output: web, pdf
diff --git a/content/docs/fundamentals/fundamentals-faq.md b/content/docs/fundamentals/fundamentals-faq.md
new file mode 100644
index 00000000000..03c7c469998
--- /dev/null
+++ b/content/docs/fundamentals/fundamentals-faq.md
@@ -0,0 +1,140 @@
+---
+layout: default
+title: FAQ
+parent: Fundamentals
+permalink: /fundamentals-faq.html
+tags: [faq]
+---
+
+<h1>preCICE Forum Browser</h1>
+<p style="color:#666;">Search and filter discussions mirrored from the preCICE Discourse forum.</p>
+
+<div style="display:flex;flex-wrap:wrap;gap:8px;margin:12px 0;">
+  <input id="q" placeholder="Search title or excerpt" style="padding:8px;border:1px solid #ddd;border-radius:8px;min-width:220px;">
+  <select id="category" style="padding:8px;border:1px solid #ddd;border-radius:8px;">
+    <option value="">All categories</option>
+  </select>
+  <input id="tag" placeholder="Tag filter" style="padding:8px;border:1px solid #ddd;border-radius:8px;min-width:160px;">
+  <select id="sort" style="padding:8px;border:1px solid #ddd;border-radius:8px;">
+    <option value="last_posted_at">Sort by last activity</option>
+    <option value="created_at">Sort by created</option>
+    <option value="posts_count">Sort by replies</option>
+    <option value="views">Sort by views</option>
+    <option value="like_count">Sort by likes</option>
+  </select>
+</div>
+
+<p id="meta" style="margin:0 0 8px 0;color:#666;"></p>
+<p id="stats" style="margin:0 0 16px 0;color:#666;"></p>
+
+<div id="list" style="display:grid;gap:12px;grid-template-columns:repeat(auto-fit,minmax(320px,1fr));"></div>
+<div id="empty" style="display:none;color:#666;padding:16px 0;text-align:center;">No results</div>
+
+<script>
+//  Dynamic proxy selection
+const apiBase =
+  window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1"
+    ? "http://localhost:3000/forum"
+    : "https://precice-forum-proxy.onrender.com/forum";
+
+window.jQuery && (jQuery.fn.navgoco = jQuery.fn.navgoco || function(){ return this; });
+
+let DATA = null;
+const el = (id) => document.getElementById(id);
+const fmtDate = (s) => (s ? new Date(s).toLocaleString() : "");
+
+function matchQuery(t, q) {
+  if (!q) return true;
+  const hay = ((t.title || "") + " " + (t.first_post_excerpt || "")).toLowerCase();
+  return hay.includes(q.toLowerCase());
+}
+const matchCategory = (t, c) => !c || t.category === c;
+function matchTag(t, tag) {
+  if (!tag) return true;
+  const tags = t.tags || [];
+  return tags.some((x) => x.toLowerCase().includes(tag.toLowerCase()));
+}
+function sortBy(arr, key) {
+  const copy = [...arr];
+  copy.sort((a, b) => {
+    if (key === "created_at" || key === "last_posted_at") {
+      return new Date(b[key] || 0) - new Date(a[key] || 0);
+    }
+    return (b[key] || 0) - (a[key] || 0);
+  });
+  return copy;
+}
+
+function render() {
+  if (!DATA) return;
+  const q = el("q").value.trim();
+  const cat = el("category").value;
+  const tag = el("tag").value.trim();
+  const sortKey = el("sort").value;
+
+  const topics = DATA.topics
+    .filter((t) => matchQuery(t, q))
+    .filter((t) => matchCategory(t, cat))
+    .filter((t) => matchTag(t, tag));
+  const sorted = sortBy(topics, sortKey);
+
+  el("stats").textContent = `Showing ${sorted.length} of ${DATA.topics.length} threads`;
+  const list = el("list");
+  list.innerHTML = "";
+  if (!sorted.length) {
+    el("empty").style.display = "";
+    return;
+  }
+  el("empty").style.display = "none";
+
+  for (const t of sorted) {
+    const card = document.createElement("article");
+    card.style.cssText = "border:1px solid #e5e7eb;border-radius:12px;padding:12px;background:#fff;";
+    card.innerHTML = `
+      <a href="${t.url}" target="_blank" rel="noopener" style="font-weight:600;text-decoration:underline;">${t.fancy_title || t.title}</a>
+      <div style="font-size:0.9em;margin-top:4px;color:#666;">
+        ${t.category || ""} · created ${fmtDate(t.created_at)} · last activity ${fmtDate(t.last_posted_at)}
+      </div>
+      <p style="margin-top:8px;">${(t.first_post_excerpt || "").replace(/\s+/g, " ").slice(0, 320)}</p>
+      <div style="margin-top:6px;display:flex;flex-wrap:wrap;gap:6px;">
+        ${(t.tags || []).map(tag => `<span style="font-size:0.75em;background:#f3f4f6;border:1px solid #e5e7eb;border-radius:999px;padding:2px 8px;">${tag}</span>`).join("")}
+      </div>
+      <div style="font-size:0.9em;margin-top:8px;display:flex;gap:12px;color:#555;">
+        <span>Replies ${t.posts_count ? t.posts_count - 1 : 0}</span>
+        <span>Views ${t.views || 0}</span>
+        <span>Likes ${t.like_count || 0}</span>
+        ${t.closed ? '<span style="color:#b91c1c;">Closed</span>' : ''}
+        ${t.pinned ? '<span style="color:#b45309;">Pinned</span>' : ''}
+      </div>
+    `;
+    list.appendChild(card);
+  }
+}
+
+async function boot() {
+  try {
+    el("stats").textContent = "Loading forum data…";
+    const res = await fetch(apiBase, { headers: { Accept: "application/json" } });
+    if (!res.ok) throw new Error(res.status + " " + res.statusText);
+    DATA = await res.json();
+
+    const cats = Array.from(new Set((DATA.topics || []).map((t) => t.category))).filter(Boolean).sort();
+    for (const c of cats) {
+      const opt = document.createElement("option");
+      opt.value = c;
+      opt.textContent = c;
+      el("category").appendChild(opt);
+    }
+
+    el("meta").textContent = `Source ${DATA.source} · Generated ${fmtDate(DATA.generated_at)}`;
+    ["q", "category", "tag", "sort"].forEach((id) => el(id).addEventListener("input", render));
+    render();
+  } catch (err) {
+    console.error("Failed to load forum data:", err);
+    el("list").innerHTML = `<div style="color:#b91c1c;">Failed to load forum data: ${String(err).replace(/</g,"&lt;")}</div>`;
+    el("stats").textContent = "";
+  }
+}
+
+boot();
+</script>
diff --git a/tools/forum-proxy.js b/tools/forum-proxy.js
new file mode 100644
index 00000000000..5c3a6e8eaf8
--- /dev/null
+++ b/tools/forum-proxy.js
@@ -0,0 +1,55 @@
+const express = require("express");
+const fetch = require("node-fetch");
+
+const app = express();
+const PORT = process.env.PORT || 3000;
+
+// Allow all origins (for frontend CORS)
+app.use((req, res, next) => {
+  res.header("Access-Control-Allow-Origin", "*");
+  next();
+});
+
+app.get("/forum", async (req, res) => {
+  try {
+    const [topicsRes, catsRes] = await Promise.all([
+      fetch("https://precice.discourse.group/latest.json"),
+      fetch("https://precice.discourse.group/categories.json"),
+    ]);
+
+    const topicsJson = await topicsRes.json();
+    const catsJson = await catsRes.json();
+
+    const catMap = {};
+    catsJson.category_list.categories.forEach((c) => (catMap[c.id] = c.name));
+
+    const topics = topicsJson.topic_list.topics.map((t) => ({
+      id: t.id,
+      slug: t.slug,
+      title: t.title,
+      fancy_title: t.fancy_title,
+      url: `https://precice.discourse.group/t/${t.slug}/${t.id}`,
+      category: catMap[t.category_id] || "General",
+      tags: t.tags || [],
+      created_at: t.created_at,
+      last_posted_at: t.last_posted_at,
+      excerpt: t.excerpt,
+      posts_count: t.posts_count,
+      views: t.views,
+      like_count: t.like_count,
+      closed: t.closed,
+      pinned: t.pinned,
+    }));
+
+    res.json({
+      source: "preCICE Discourse (live)",
+      generated_at: new Date().toISOString(),
+      topics,
+    });
+  } catch (err) {
+    console.error("Proxy error:", err);
+    res.status(500).json({ error: "Failed to fetch forum data" });
+  }
+});
+
+app.listen(PORT, () => console.log(`Forum proxy running on port ${PORT}`));

From c7a599bbd40171717b049a92a60b891e724761ee Mon Sep 17 00:00:00 2001
From: Paul Gaikwad <gaikwadpaul05@gmail.com>
Date: Sat, 18 Oct 2025 21:15:40 +0200
Subject: [PATCH 02/10] =?UTF-8?q?make=20FAQ=20section=20production-ready?=
 =?UTF-8?q?=20with=20cleaner=20UI=20and=20resilient=20forum=20fetching=20?=
 =?UTF-8?q?=20=20-=20Simplified=20FAQ=20page=20layout=20(removed=20categor?=
 =?UTF-8?q?y=20and=20tag=20filters)=20=20=20-=20Updated=20text=20and=20str?=
 =?UTF-8?q?ucture=20for=20clarity=20and=20usability=20=20=20-=20Added=20pr?=
 =?UTF-8?q?oduction-grade=20forum-fetch.js=20with:=20=20=20=20=20=E2=80=A2?=
 =?UTF-8?q?=20Retry=20and=20timeout=20logic=20for=20robust=20data=20fetchi?=
 =?UTF-8?q?ng=20=20=20=20=20=E2=80=A2=20Improved=20loading=20and=20error?=
 =?UTF-8?q?=20feedback=20for=20users=20=20=20=20=20=E2=80=A2=20Cleaner=20F?=
 =?UTF-8?q?AQ=20card=20design=20with=20hover=20effects=20=20=20-=20Integra?=
 =?UTF-8?q?ted=20backend=20proxy=20for=20fetching=20FAQ-tagged=20Discourse?=
 =?UTF-8?q?=20topics?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 content/docs/fundamentals/fundamentals-faq.md | 123 +----------------
 js/forum-fetch.js                             | 127 ++++++++++++++++++
 package.json                                  |  87 ++++++++++++
 tools/forum-proxy.js                          |  43 ++----
 4 files changed, 230 insertions(+), 150 deletions(-)
 create mode 100644 js/forum-fetch.js
 create mode 100644 package.json

diff --git a/content/docs/fundamentals/fundamentals-faq.md b/content/docs/fundamentals/fundamentals-faq.md
index 03c7c469998..27d0228583d 100644
--- a/content/docs/fundamentals/fundamentals-faq.md
+++ b/content/docs/fundamentals/fundamentals-faq.md
@@ -6,18 +6,14 @@ permalink: /fundamentals-faq.html
 tags: [faq]
 ---
 
-<h1>preCICE Forum Browser</h1>
-<p style="color:#666;">Search and filter discussions mirrored from the preCICE Discourse forum.</p>
+<h1>Frequently Asked Questions</h1>
+<p style="color:#666;">Browse and search frequently asked questions mirrored from the preCICE Discourse forum.</p>
 
 <div style="display:flex;flex-wrap:wrap;gap:8px;margin:12px 0;">
-  <input id="q" placeholder="Search title or excerpt" style="padding:8px;border:1px solid #ddd;border-radius:8px;min-width:220px;">
-  <select id="category" style="padding:8px;border:1px solid #ddd;border-radius:8px;">
-    <option value="">All categories</option>
-  </select>
-  <input id="tag" placeholder="Tag filter" style="padding:8px;border:1px solid #ddd;border-radius:8px;min-width:160px;">
+  <input id="q" placeholder="Search questions..." style="padding:8px;border:1px solid #ddd;border-radius:8px;min-width:240px;">
   <select id="sort" style="padding:8px;border:1px solid #ddd;border-radius:8px;">
     <option value="last_posted_at">Sort by last activity</option>
-    <option value="created_at">Sort by created</option>
+    <option value="created_at">Sort by creation date</option>
     <option value="posts_count">Sort by replies</option>
     <option value="views">Sort by views</option>
     <option value="like_count">Sort by likes</option>
@@ -28,113 +24,6 @@ tags: [faq]
 <p id="stats" style="margin:0 0 16px 0;color:#666;"></p>
 
 <div id="list" style="display:grid;gap:12px;grid-template-columns:repeat(auto-fit,minmax(320px,1fr));"></div>
-<div id="empty" style="display:none;color:#666;padding:16px 0;text-align:center;">No results</div>
-
-<script>
-//  Dynamic proxy selection
-const apiBase =
-  window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1"
-    ? "http://localhost:3000/forum"
-    : "https://precice-forum-proxy.onrender.com/forum";
-
-window.jQuery && (jQuery.fn.navgoco = jQuery.fn.navgoco || function(){ return this; });
-
-let DATA = null;
-const el = (id) => document.getElementById(id);
-const fmtDate = (s) => (s ? new Date(s).toLocaleString() : "");
-
-function matchQuery(t, q) {
-  if (!q) return true;
-  const hay = ((t.title || "") + " " + (t.first_post_excerpt || "")).toLowerCase();
-  return hay.includes(q.toLowerCase());
-}
-const matchCategory = (t, c) => !c || t.category === c;
-function matchTag(t, tag) {
-  if (!tag) return true;
-  const tags = t.tags || [];
-  return tags.some((x) => x.toLowerCase().includes(tag.toLowerCase()));
-}
-function sortBy(arr, key) {
-  const copy = [...arr];
-  copy.sort((a, b) => {
-    if (key === "created_at" || key === "last_posted_at") {
-      return new Date(b[key] || 0) - new Date(a[key] || 0);
-    }
-    return (b[key] || 0) - (a[key] || 0);
-  });
-  return copy;
-}
-
-function render() {
-  if (!DATA) return;
-  const q = el("q").value.trim();
-  const cat = el("category").value;
-  const tag = el("tag").value.trim();
-  const sortKey = el("sort").value;
-
-  const topics = DATA.topics
-    .filter((t) => matchQuery(t, q))
-    .filter((t) => matchCategory(t, cat))
-    .filter((t) => matchTag(t, tag));
-  const sorted = sortBy(topics, sortKey);
-
-  el("stats").textContent = `Showing ${sorted.length} of ${DATA.topics.length} threads`;
-  const list = el("list");
-  list.innerHTML = "";
-  if (!sorted.length) {
-    el("empty").style.display = "";
-    return;
-  }
-  el("empty").style.display = "none";
-
-  for (const t of sorted) {
-    const card = document.createElement("article");
-    card.style.cssText = "border:1px solid #e5e7eb;border-radius:12px;padding:12px;background:#fff;";
-    card.innerHTML = `
-      <a href="${t.url}" target="_blank" rel="noopener" style="font-weight:600;text-decoration:underline;">${t.fancy_title || t.title}</a>
-      <div style="font-size:0.9em;margin-top:4px;color:#666;">
-        ${t.category || ""} · created ${fmtDate(t.created_at)} · last activity ${fmtDate(t.last_posted_at)}
-      </div>
-      <p style="margin-top:8px;">${(t.first_post_excerpt || "").replace(/\s+/g, " ").slice(0, 320)}</p>
-      <div style="margin-top:6px;display:flex;flex-wrap:wrap;gap:6px;">
-        ${(t.tags || []).map(tag => `<span style="font-size:0.75em;background:#f3f4f6;border:1px solid #e5e7eb;border-radius:999px;padding:2px 8px;">${tag}</span>`).join("")}
-      </div>
-      <div style="font-size:0.9em;margin-top:8px;display:flex;gap:12px;color:#555;">
-        <span>Replies ${t.posts_count ? t.posts_count - 1 : 0}</span>
-        <span>Views ${t.views || 0}</span>
-        <span>Likes ${t.like_count || 0}</span>
-        ${t.closed ? '<span style="color:#b91c1c;">Closed</span>' : ''}
-        ${t.pinned ? '<span style="color:#b45309;">Pinned</span>' : ''}
-      </div>
-    `;
-    list.appendChild(card);
-  }
-}
-
-async function boot() {
-  try {
-    el("stats").textContent = "Loading forum data…";
-    const res = await fetch(apiBase, { headers: { Accept: "application/json" } });
-    if (!res.ok) throw new Error(res.status + " " + res.statusText);
-    DATA = await res.json();
-
-    const cats = Array.from(new Set((DATA.topics || []).map((t) => t.category))).filter(Boolean).sort();
-    for (const c of cats) {
-      const opt = document.createElement("option");
-      opt.value = c;
-      opt.textContent = c;
-      el("category").appendChild(opt);
-    }
-
-    el("meta").textContent = `Source ${DATA.source} · Generated ${fmtDate(DATA.generated_at)}`;
-    ["q", "category", "tag", "sort"].forEach((id) => el(id).addEventListener("input", render));
-    render();
-  } catch (err) {
-    console.error("Failed to load forum data:", err);
-    el("list").innerHTML = `<div style="color:#b91c1c;">Failed to load forum data: ${String(err).replace(/</g,"&lt;")}</div>`;
-    el("stats").textContent = "";
-  }
-}
+<div id="empty" style="display:none;color:#666;padding:16px 0;text-align:center;">No results found.</div>
 
-boot();
-</script>
+<script src="/js/forum-fetch.js"></script>
diff --git a/js/forum-fetch.js b/js/forum-fetch.js
new file mode 100644
index 00000000000..19d0c4e55d3
--- /dev/null
+++ b/js/forum-fetch.js
@@ -0,0 +1,127 @@
+// js/forum-fetch.js — Production-Ready FAQ Fetcher
+
+// --- Select proxy URL ---
+const apiBase =
+  window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1"
+    ? "http://localhost:3000/forum"
+    : "https://precice-forum-proxy.onrender.com/forum";
+
+let DATA = null;
+const el = (id) => document.getElementById(id);
+const fmtDate = (s) => (s ? new Date(s).toLocaleString() : "");
+
+// --- Timeout helper ---
+async function fetchWithTimeout(resource, options = {}) {
+  const { timeout = 10000 } = options; // 10 seconds
+  const controller = new AbortController();
+  const id = setTimeout(() => controller.abort(), timeout);
+  const response = await fetch(resource, { ...options, signal: controller.signal });
+  clearTimeout(id);
+  return response;
+}
+
+// --- Retry helper ---
+async function fetchWithRetry(url, retries = 2, delay = 1500) {
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    try {
+      const res = await fetchWithTimeout(url, { headers: { Accept: "application/json" } });
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return await res.json();
+    } catch (err) {
+      if (attempt < retries) {
+        console.warn(`Fetch attempt ${attempt + 1} failed, retrying in ${delay}ms...`, err);
+        await new Promise((r) => setTimeout(r, delay));
+      } else {
+        throw err;
+      }
+    }
+  }
+}
+
+// --- Filtering and sorting helpers ---
+function matchQuery(t, q) {
+  if (!q) return true;
+  const hay = ((t.title || "") + " " + (t.excerpt || "")).toLowerCase();
+  return hay.includes(q.toLowerCase());
+}
+
+function sortBy(arr, key) {
+  const copy = [...arr];
+  copy.sort((a, b) => {
+    if (key === "created_at" || key === "last_posted_at") {
+      return new Date(b[key] || 0) - new Date(a[key] || 0);
+    }
+    return (b[key] || 0) - (a[key] || 0);
+  });
+  return copy;
+}
+
+// --- Rendering logic ---
+function render() {
+  if (!DATA) return;
+
+  const q = el("q").value.trim();
+  const sortKey = el("sort").value;
+  const topics = DATA.topic_list.topics.filter((t) => matchQuery(t, q));
+  const sorted = sortBy(topics, sortKey);
+
+  el("stats").textContent = `Showing ${sorted.length} FAQ threads`;
+  const list = el("list");
+  list.innerHTML = "";
+
+  if (!sorted.length) {
+    el("empty").style.display = "";
+    return;
+  }
+  el("empty").style.display = "none";
+
+  for (const t of sorted) {
+    const card = document.createElement("article");
+    card.style.cssText =
+      "border:1px solid #e5e7eb;border-radius:12px;padding:12px;background:#fff;transition:box-shadow 0.2s ease;cursor:pointer;";
+    card.onmouseenter = () => (card.style.boxShadow = "0 2px 6px rgba(0,0,0,0.1)");
+    card.onmouseleave = () => (card.style.boxShadow = "none");
+
+    card.innerHTML = `
+      <a href="https://precice.discourse.group/t/${t.slug}/${t.id}" target="_blank" rel="noopener"
+         style="font-weight:600;text-decoration:underline;">
+        ${t.fancy_title || t.title}
+      </a>
+      <div style="font-size:0.9em;margin-top:4px;color:#666;">
+        Created ${fmtDate(t.created_at)} · Last activity ${fmtDate(t.last_posted_at)}
+      </div>
+      <p style="margin-top:8px;">${(t.excerpt || "").replace(/\s+/g, " ").slice(0, 320)}</p>
+      <div style="font-size:0.9em;margin-top:8px;display:flex;gap:12px;color:#555;">
+        <span>Replies ${t.posts_count ? t.posts_count - 1 : 0}</span>
+        <span>Views ${t.views || 0}</span>
+        <span>Likes ${t.like_count || 0}</span>
+      </div>
+    `;
+    list.appendChild(card);
+  }
+}
+
+// --- Boot logic ---
+async function boot() {
+  const list = el("list");
+  try {
+    list.innerHTML = `<div style="text-align:center;padding:40px;color:#666;"> Loading FAQ topics…</div>`;
+    el("stats").textContent = "";
+
+    DATA = await fetchWithRetry(apiBase, 2, 1500);
+
+    el("meta").textContent = `Source: preCICE Discourse · Generated ${fmtDate(new Date())}`;
+    ["q", "sort"].forEach((id) => el(id).addEventListener("input", render));
+
+    render();
+  } catch (err) {
+    console.error("Failed to load forum data:", err);
+    list.innerHTML = `<div style="color:#b91c1c;text-align:center;padding:30px;">
+      Unable to load FAQ topics. Please check your internet connection or try again later.
+    </div>`;
+    el("stats").textContent = "";
+  }
+}
+
+// --- Initialize on DOM ready ---
+window.addEventListener("DOMContentLoaded", boot);
diff --git a/package.json b/package.json
new file mode 100644
index 00000000000..bd6bf72c392
--- /dev/null
+++ b/package.json
@@ -0,0 +1,87 @@
+{
+  "name": "precice.github.io",
+  "version": "1.0.0",
+  "description": "The website is using [Jekyll](https://jekyllrb.com/) static website generator and [Github pages](https://pages.github.com/).\r To run and develop it locally you would need [Ruby](https://www.ruby-lang.org/en/) and [Bundler](https://bundler.io/).\r With Ruby, you can install bundler using `gem install bundler`.\r Then install [`pre-commit`](https://repology.org/project/python:pre-commit/versions) to keep your commits clean.",
+  "main": "index.js",
+  "dependencies": {
+    "accepts": "^2.0.0",
+    "body-parser": "^2.2.0",
+    "bytes": "^3.1.2",
+    "call-bind-apply-helpers": "^1.0.2",
+    "call-bound": "^1.0.4",
+    "content-disposition": "^1.0.0",
+    "content-type": "^1.0.5",
+    "cookie": "^0.7.2",
+    "cookie-signature": "^1.2.2",
+    "cors": "^2.8.5",
+    "debug": "^4.4.3",
+    "depd": "^2.0.0",
+    "dunder-proto": "^1.0.1",
+    "ee-first": "^1.1.1",
+    "encodeurl": "^2.0.0",
+    "es-define-property": "^1.0.1",
+    "es-errors": "^1.3.0",
+    "es-object-atoms": "^1.1.1",
+    "escape-html": "^1.0.3",
+    "etag": "^1.8.1",
+    "express": "^5.1.0",
+    "finalhandler": "^2.1.0",
+    "forwarded": "^0.2.0",
+    "fresh": "^2.0.0",
+    "function-bind": "^1.1.2",
+    "get-intrinsic": "^1.3.0",
+    "get-proto": "^1.0.1",
+    "gopd": "^1.2.0",
+    "has-symbols": "^1.1.0",
+    "hasown": "^2.0.2",
+    "http-errors": "^2.0.0",
+    "iconv-lite": "^0.6.3",
+    "inherits": "^2.0.4",
+    "ipaddr.js": "^1.9.1",
+    "is-promise": "^4.0.0",
+    "math-intrinsics": "^1.1.0",
+    "media-typer": "^1.1.0",
+    "merge-descriptors": "^2.0.0",
+    "mime-db": "^1.54.0",
+    "mime-types": "^3.0.1",
+    "ms": "^2.1.3",
+    "negotiator": "^1.0.0",
+    "node-fetch": "^2.7.0",
+    "object-assign": "^4.1.1",
+    "object-inspect": "^1.13.4",
+    "on-finished": "^2.4.1",
+    "once": "^1.4.0",
+    "parseurl": "^1.3.3",
+    "path-to-regexp": "^8.3.0",
+    "proxy-addr": "^2.0.7",
+    "qs": "^6.14.0",
+    "range-parser": "^1.2.1",
+    "raw-body": "^3.0.1",
+    "router": "^2.2.0",
+    "safe-buffer": "^5.2.1",
+    "safer-buffer": "^2.1.2",
+    "send": "^1.2.0",
+    "serve-static": "^2.2.0",
+    "setprototypeof": "^1.2.0",
+    "side-channel": "^1.1.0",
+    "side-channel-list": "^1.0.0",
+    "side-channel-map": "^1.0.1",
+    "side-channel-weakmap": "^1.0.2",
+    "statuses": "^2.0.2",
+    "toidentifier": "^1.0.1",
+    "tr46": "^0.0.3",
+    "type-is": "^2.0.1",
+    "unpipe": "^1.0.0",
+    "vary": "^1.1.2",
+    "webidl-conversions": "^3.0.1",
+    "whatwg-url": "^5.0.0",
+    "wrappy": "^1.0.2"
+  },
+  "devDependencies": {},
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC"
+}
diff --git a/tools/forum-proxy.js b/tools/forum-proxy.js
index 5c3a6e8eaf8..4815875657c 100644
--- a/tools/forum-proxy.js
+++ b/tools/forum-proxy.js
@@ -1,10 +1,11 @@
+// tools/forum-proxy.js
 const express = require("express");
 const fetch = require("node-fetch");
 
 const app = express();
 const PORT = process.env.PORT || 3000;
+const BASE_URL = "https://precice.discourse.group";
 
-// Allow all origins (for frontend CORS)
 app.use((req, res, next) => {
   res.header("Access-Control-Allow-Origin", "*");
   next();
@@ -12,43 +13,19 @@ app.use((req, res, next) => {
 
 app.get("/forum", async (req, res) => {
   try {
-    const [topicsRes, catsRes] = await Promise.all([
-      fetch("https://precice.discourse.group/latest.json"),
-      fetch("https://precice.discourse.group/categories.json"),
-    ]);
+    const tag = req.query.tag || "faq"; // Default tag is 'faq'
+    const endpoint = `/tag/${encodeURIComponent(tag)}/l/latest.json`;
 
-    const topicsJson = await topicsRes.json();
-    const catsJson = await catsRes.json();
+    console.log(`Fetching from: ${BASE_URL}${endpoint}`);
 
-    const catMap = {};
-    catsJson.category_list.categories.forEach((c) => (catMap[c.id] = c.name));
+    const response = await fetch(`${BASE_URL}${endpoint}`);
+    if (!response.ok) throw new Error(`HTTP ${response.status}`);
+    const json = await response.json();
 
-    const topics = topicsJson.topic_list.topics.map((t) => ({
-      id: t.id,
-      slug: t.slug,
-      title: t.title,
-      fancy_title: t.fancy_title,
-      url: `https://precice.discourse.group/t/${t.slug}/${t.id}`,
-      category: catMap[t.category_id] || "General",
-      tags: t.tags || [],
-      created_at: t.created_at,
-      last_posted_at: t.last_posted_at,
-      excerpt: t.excerpt,
-      posts_count: t.posts_count,
-      views: t.views,
-      like_count: t.like_count,
-      closed: t.closed,
-      pinned: t.pinned,
-    }));
-
-    res.json({
-      source: "preCICE Discourse (live)",
-      generated_at: new Date().toISOString(),
-      topics,
-    });
+    res.json(json);
   } catch (err) {
     console.error("Proxy error:", err);
-    res.status(500).json({ error: "Failed to fetch forum data" });
+    res.status(500).json({ error: "Failed to fetch forum data", details: String(err) });
   }
 });
 

From 313431d8e1cf55a30d6498a20266ac72bfe08975 Mon Sep 17 00:00:00 2001
From: Paul Gaikwad <gaikwadpaul05@gmail.com>
Date: Thu, 23 Oct 2025 14:33:01 +0200
Subject: [PATCH 03/10] feat(faq): add search and sorting with load-more
 support for static FAQ data

- Added "Load more" pagination to display 10 items initially with incremental loading
- Removed dependency on live Discourse fetch; now fully works with CI-generated JSON
---
 .github/workflows/fetch-faq.yml |  34 +++++
 js/forum-fetch.js               | 221 +++++++++++++++-----------------
 tools/fetch-faq.js              |  68 ++++++++++
 3 files changed, 204 insertions(+), 119 deletions(-)
 create mode 100644 .github/workflows/fetch-faq.yml
 create mode 100644 tools/fetch-faq.js

diff --git a/.github/workflows/fetch-faq.yml b/.github/workflows/fetch-faq.yml
new file mode 100644
index 00000000000..94acc956101
--- /dev/null
+++ b/.github/workflows/fetch-faq.yml
@@ -0,0 +1,34 @@
+name: Fetch FAQ Data
+
+on:
+  schedule:
+    - cron: "0 6 * * *"  # Every day at 6 AM UTC
+  workflow_dispatch:      # Allow manual run
+
+jobs:
+  fetch-faq:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "18"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Fetch latest FAQ data from Discourse
+        run: node tools/fetch-faq.js
+
+      - name: Commit and push changes
+        run: |
+          git config user.name "GitHub Actions"
+          git config user.email "actions@github.com"
+          git add assets/data/faq.json
+          git commit -m "ci(faq): update faq.json with latest excerpts from Discourse" || echo "No changes to commit"
+          git push origin HEAD:feature/faq-static-fetch
+        continue-on-error: true
diff --git a/js/forum-fetch.js b/js/forum-fetch.js
index 19d0c4e55d3..e81ca0ce960 100644
--- a/js/forum-fetch.js
+++ b/js/forum-fetch.js
@@ -1,127 +1,110 @@
-// js/forum-fetch.js — Production-Ready FAQ Fetcher
-
-// --- Select proxy URL ---
-const apiBase =
-  window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1"
-    ? "http://localhost:3000/forum"
-    : "https://precice-forum-proxy.onrender.com/forum";
-
-let DATA = null;
-const el = (id) => document.getElementById(id);
-const fmtDate = (s) => (s ? new Date(s).toLocaleString() : "");
-
-// --- Timeout helper ---
-async function fetchWithTimeout(resource, options = {}) {
-  const { timeout = 10000 } = options; // 10 seconds
-  const controller = new AbortController();
-  const id = setTimeout(() => controller.abort(), timeout);
-  const response = await fetch(resource, { ...options, signal: controller.signal });
-  clearTimeout(id);
-  return response;
-}
-
-// --- Retry helper ---
-async function fetchWithRetry(url, retries = 2, delay = 1500) {
-  for (let attempt = 0; attempt <= retries; attempt++) {
-    try {
-      const res = await fetchWithTimeout(url, { headers: { Accept: "application/json" } });
-      if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      return await res.json();
-    } catch (err) {
-      if (attempt < retries) {
-        console.warn(`Fetch attempt ${attempt + 1} failed, retrying in ${delay}ms...`, err);
-        await new Promise((r) => setTimeout(r, delay));
-      } else {
-        throw err;
-      }
+console.log("forum-fetch.js loaded!");
+
+document.addEventListener("DOMContentLoaded", async function () {
+  console.log("FAQ loader running...");
+
+  const list = document.getElementById("list");
+  const empty = document.getElementById("empty");
+  const searchInput = document.getElementById("q");
+  const sortSelect = document.getElementById("sort");
+
+  const loadingText = document.createElement("p");
+  loadingText.textContent = "Loading FAQs...";
+  list.parentElement.insertBefore(loadingText, list);
+
+  try {
+    const res = await fetch("/assets/data/faq.json");
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+
+    const data = await res.json();
+    const topics = data.topics || [];
+    loadingText.remove();
+
+    if (!topics.length) {
+      empty.style.display = "block";
+      return;
     }
-  }
-}
-
-// --- Filtering and sorting helpers ---
-function matchQuery(t, q) {
-  if (!q) return true;
-  const hay = ((t.title || "") + " " + (t.excerpt || "")).toLowerCase();
-  return hay.includes(q.toLowerCase());
-}
-
-function sortBy(arr, key) {
-  const copy = [...arr];
-  copy.sort((a, b) => {
-    if (key === "created_at" || key === "last_posted_at") {
-      return new Date(b[key] || 0) - new Date(a[key] || 0);
+
+    let visibleCount = 10;
+    let filteredTopics = [...topics];
+
+    function filterAndSort() {
+      const q = searchInput.value.trim().toLowerCase();
+      const sortKey = sortSelect.value;
+
+      // Filter
+      filteredTopics = topics.filter((t) =>
+        (t.title + " " + (t.excerpt || ""))
+          .toLowerCase()
+          .includes(q)
+      );
+
+      // Sort
+      filteredTopics.sort((a, b) => {
+        if (sortKey === "created_at" || sortKey === "last_posted_at") {
+          return new Date(b[sortKey]) - new Date(a[sortKey]);
+        }
+        return (b[sortKey] || 0) - (a[sortKey] || 0);
+      });
+
+      visibleCount = 10;
+      renderTopics();
     }
-    return (b[key] || 0) - (a[key] || 0);
-  });
-  return copy;
-}
-
-// --- Rendering logic ---
-function render() {
-  if (!DATA) return;
-
-  const q = el("q").value.trim();
-  const sortKey = el("sort").value;
-  const topics = DATA.topic_list.topics.filter((t) => matchQuery(t, q));
-  const sorted = sortBy(topics, sortKey);
-
-  el("stats").textContent = `Showing ${sorted.length} FAQ threads`;
-  const list = el("list");
-  list.innerHTML = "";
-
-  if (!sorted.length) {
-    el("empty").style.display = "";
-    return;
-  }
-  el("empty").style.display = "none";
-
-  for (const t of sorted) {
-    const card = document.createElement("article");
-    card.style.cssText =
-      "border:1px solid #e5e7eb;border-radius:12px;padding:12px;background:#fff;transition:box-shadow 0.2s ease;cursor:pointer;";
-    card.onmouseenter = () => (card.style.boxShadow = "0 2px 6px rgba(0,0,0,0.1)");
-    card.onmouseleave = () => (card.style.boxShadow = "none");
-
-    card.innerHTML = `
-      <a href="https://precice.discourse.group/t/${t.slug}/${t.id}" target="_blank" rel="noopener"
-         style="font-weight:600;text-decoration:underline;">
-        ${t.fancy_title || t.title}
-      </a>
-      <div style="font-size:0.9em;margin-top:4px;color:#666;">
-        Created ${fmtDate(t.created_at)} · Last activity ${fmtDate(t.last_posted_at)}
-      </div>
-      <p style="margin-top:8px;">${(t.excerpt || "").replace(/\s+/g, " ").slice(0, 320)}</p>
-      <div style="font-size:0.9em;margin-top:8px;display:flex;gap:12px;color:#555;">
-        <span>Replies ${t.posts_count ? t.posts_count - 1 : 0}</span>
-        <span>Views ${t.views || 0}</span>
-        <span>Likes ${t.like_count || 0}</span>
-      </div>
-    `;
-    list.appendChild(card);
-  }
-}
 
-// --- Boot logic ---
-async function boot() {
-  const list = el("list");
-  try {
-    list.innerHTML = `<div style="text-align:center;padding:40px;color:#666;"> Loading FAQ topics…</div>`;
-    el("stats").textContent = "";
+    function renderTopics() {
+      list.innerHTML = "";
+
+      const shown = filteredTopics.slice(0, visibleCount);
+
+      if (!shown.length) {
+        empty.style.display = "block";
+        return;
+      } else {
+        empty.style.display = "none";
+      }
 
-    DATA = await fetchWithRetry(apiBase, 2, 1500);
+      shown.forEach((t) => {
+        const card = document.createElement("div");
+        card.className = "faq-card";
+        card.style.cssText =
+          "border:1px solid #ddd;padding:12px;border-radius:8px;background:#fff;";
+
+        card.innerHTML = `
+          <h4>
+            <a href="${t.url}" target="_blank" rel="noopener noreferrer" style="text-decoration:none;color:#0069c2;">
+              ${t.title}
+            </a>
+          </h4>
+          <p style="color:#333;">${t.excerpt || "No description available."}</p>
+          <p style="color:#666;font-size:0.9em;">
+            Last updated: ${new Date(t.last_posted_at).toLocaleDateString()} |
+            Replies: ${t.posts_count} | Views: ${t.views}
+          </p>
+        `;
+        list.appendChild(card);
+      });
+
+      if (visibleCount < filteredTopics.length) {
+        const btn = document.createElement("button");
+        btn.textContent = "Load more";
+        btn.style.cssText =
+          "padding:8px 16px;margin:12px auto;display:block;border:1px solid #ccc;border-radius:8px;background:#f9f9f9;cursor:pointer;";
+        btn.addEventListener("click", () => {
+          visibleCount += 10;
+          renderTopics();
+        });
+        list.appendChild(btn);
+      }
+    }
 
-    el("meta").textContent = `Source: preCICE Discourse · Generated ${fmtDate(new Date())}`;
-    ["q", "sort"].forEach((id) => el(id).addEventListener("input", render));
+    // Event listeners
+    searchInput.addEventListener("input", filterAndSort);
+    sortSelect.addEventListener("change", filterAndSort);
 
-    render();
+    // Initial render
+    filterAndSort();
   } catch (err) {
-    console.error("Failed to load forum data:", err);
-    list.innerHTML = `<div style="color:#b91c1c;text-align:center;padding:30px;">
-      Unable to load FAQ topics. Please check your internet connection or try again later.
-    </div>`;
-    el("stats").textContent = "";
+    console.error("Error loading FAQ:", err);
+    loadingText.textContent = "Failed to load FAQs.";
   }
-}
-
-// --- Initialize on DOM ready ---
-window.addEventListener("DOMContentLoaded", boot);
+});
diff --git a/tools/fetch-faq.js b/tools/fetch-faq.js
new file mode 100644
index 00000000000..df1f7e7a206
--- /dev/null
+++ b/tools/fetch-faq.js
@@ -0,0 +1,68 @@
+// tools/fetch-faq.js
+const fs = require("fs");
+const fetch = require("node-fetch");
+
+const DISCOURSE_BASE = "https://precice.discourse.group";
+const OUTPUT_FILE = "./assets/data/faq.json";
+
+async function fetchExcerpt(topicId) {
+  try {
+    const res = await fetch(`${DISCOURSE_BASE}/t/${topicId}.json`);
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    const topicData = await res.json();
+    // Get first post excerpt (trimmed and cleaned)
+    const rawExcerpt =
+      topicData.post_stream?.posts?.[0]?.cooked?.replace(/<[^>]+>/g, "") || "";
+    return rawExcerpt.substring(0, 250) + (rawExcerpt.length > 250 ? "…" : "");
+  } catch (err) {
+    console.warn(`⚠️ Could not fetch excerpt for topic ${topicId}: ${err.message}`);
+    return "";
+  }
+}
+
+async function fetchFAQ() {
+  try {
+    console.log("📥 Fetching FAQ topics from Discourse...");
+
+    const res = await fetch(`${DISCOURSE_BASE}/tag/faq/l/latest.json`);
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+
+    const json = await res.json();
+    const topicList = json.topic_list?.topics || [];
+    console.log(`Found ${topicList.length} FAQ topics. Fetching excerpts...`);
+
+    // Parallel fetch excerpts
+    const topics = await Promise.all(
+      topicList.map(async (t) => {
+        const excerpt = await fetchExcerpt(t.id);
+        return {
+          id: t.id,
+          title: t.title,
+          slug: t.slug,
+          url: `${DISCOURSE_BASE}/t/${t.slug}/${t.id}`,
+          created_at: t.created_at,
+          last_posted_at: t.last_posted_at,
+          views: t.views,
+          posts_count: t.posts_count,
+          like_count: t.like_count,
+          excerpt: excerpt,
+        };
+      })
+    );
+
+    const payload = {
+      source: "preCICE Discourse (FAQ)",
+      generated_at: new Date().toISOString(),
+      topics,
+    };
+
+    fs.mkdirSync("./assets/data", { recursive: true });
+    fs.writeFileSync(OUTPUT_FILE, JSON.stringify(payload, null, 2));
+    console.log(`✅ Saved ${topics.length} FAQ topics with excerpts to ${OUTPUT_FILE}`);
+  } catch (err) {
+    console.error("❌ Failed to fetch FAQ data:", err);
+    process.exit(1);
+  }
+}
+
+fetchFAQ();

From 5d2663f7f286ad6d2c3b6741e7e05f4eac6ecf54 Mon Sep 17 00:00:00 2001
From: Paul Gaikwad <gaikwadpaul05@gmail.com>
Date: Mon, 27 Oct 2025 01:46:34 +0100
Subject: [PATCH 04/10] Adjusted the position of the Load more button

---
 js/forum-fetch.js | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/js/forum-fetch.js b/js/forum-fetch.js
index e81ca0ce960..d8f9c723818 100644
--- a/js/forum-fetch.js
+++ b/js/forum-fetch.js
@@ -88,7 +88,8 @@ document.addEventListener("DOMContentLoaded", async function () {
         const btn = document.createElement("button");
         btn.textContent = "Load more";
         btn.style.cssText =
-          "padding:8px 16px;margin:12px auto;display:block;border:1px solid #ccc;border-radius:8px;background:#f9f9f9;cursor:pointer;";
+      "padding:8px 16px;margin:12px 0 12px auto;display:block;border:1px solid #ccc;border-radius:8px;background:#f9f9f9;cursor:pointer;";
+
         btn.addEventListener("click", () => {
           visibleCount += 10;
           renderTopics();

From d420cb74d9a85875b7cdcfa8ea95c6e95cbec496 Mon Sep 17 00:00:00 2001
From: Paul Gaikwad <gaikwadpaul05@gmail.com>
Date: Mon, 27 Oct 2025 14:53:41 +0100
Subject: [PATCH 05/10] Removed Files fetch-faq, forum-proxy.js as they are
 redundant in the current static fetching update

---
 tools/fetch-faq.js   | 68 --------------------------------------------
 tools/forum-proxy.js | 32 ---------------------
 2 files changed, 100 deletions(-)
 delete mode 100644 tools/fetch-faq.js
 delete mode 100644 tools/forum-proxy.js

diff --git a/tools/fetch-faq.js b/tools/fetch-faq.js
deleted file mode 100644
index df1f7e7a206..00000000000
--- a/tools/fetch-faq.js
+++ /dev/null
@@ -1,68 +0,0 @@
-// tools/fetch-faq.js
-const fs = require("fs");
-const fetch = require("node-fetch");
-
-const DISCOURSE_BASE = "https://precice.discourse.group";
-const OUTPUT_FILE = "./assets/data/faq.json";
-
-async function fetchExcerpt(topicId) {
-  try {
-    const res = await fetch(`${DISCOURSE_BASE}/t/${topicId}.json`);
-    if (!res.ok) throw new Error(`HTTP ${res.status}`);
-    const topicData = await res.json();
-    // Get first post excerpt (trimmed and cleaned)
-    const rawExcerpt =
-      topicData.post_stream?.posts?.[0]?.cooked?.replace(/<[^>]+>/g, "") || "";
-    return rawExcerpt.substring(0, 250) + (rawExcerpt.length > 250 ? "…" : "");
-  } catch (err) {
-    console.warn(`⚠️ Could not fetch excerpt for topic ${topicId}: ${err.message}`);
-    return "";
-  }
-}
-
-async function fetchFAQ() {
-  try {
-    console.log("📥 Fetching FAQ topics from Discourse...");
-
-    const res = await fetch(`${DISCOURSE_BASE}/tag/faq/l/latest.json`);
-    if (!res.ok) throw new Error(`HTTP ${res.status}`);
-
-    const json = await res.json();
-    const topicList = json.topic_list?.topics || [];
-    console.log(`Found ${topicList.length} FAQ topics. Fetching excerpts...`);
-
-    // Parallel fetch excerpts
-    const topics = await Promise.all(
-      topicList.map(async (t) => {
-        const excerpt = await fetchExcerpt(t.id);
-        return {
-          id: t.id,
-          title: t.title,
-          slug: t.slug,
-          url: `${DISCOURSE_BASE}/t/${t.slug}/${t.id}`,
-          created_at: t.created_at,
-          last_posted_at: t.last_posted_at,
-          views: t.views,
-          posts_count: t.posts_count,
-          like_count: t.like_count,
-          excerpt: excerpt,
-        };
-      })
-    );
-
-    const payload = {
-      source: "preCICE Discourse (FAQ)",
-      generated_at: new Date().toISOString(),
-      topics,
-    };
-
-    fs.mkdirSync("./assets/data", { recursive: true });
-    fs.writeFileSync(OUTPUT_FILE, JSON.stringify(payload, null, 2));
-    console.log(`✅ Saved ${topics.length} FAQ topics with excerpts to ${OUTPUT_FILE}`);
-  } catch (err) {
-    console.error("❌ Failed to fetch FAQ data:", err);
-    process.exit(1);
-  }
-}
-
-fetchFAQ();
diff --git a/tools/forum-proxy.js b/tools/forum-proxy.js
deleted file mode 100644
index 4815875657c..00000000000
--- a/tools/forum-proxy.js
+++ /dev/null
@@ -1,32 +0,0 @@
-// tools/forum-proxy.js
-const express = require("express");
-const fetch = require("node-fetch");
-
-const app = express();
-const PORT = process.env.PORT || 3000;
-const BASE_URL = "https://precice.discourse.group";
-
-app.use((req, res, next) => {
-  res.header("Access-Control-Allow-Origin", "*");
-  next();
-});
-
-app.get("/forum", async (req, res) => {
-  try {
-    const tag = req.query.tag || "faq"; // Default tag is 'faq'
-    const endpoint = `/tag/${encodeURIComponent(tag)}/l/latest.json`;
-
-    console.log(`Fetching from: ${BASE_URL}${endpoint}`);
-
-    const response = await fetch(`${BASE_URL}${endpoint}`);
-    if (!response.ok) throw new Error(`HTTP ${response.status}`);
-    const json = await response.json();
-
-    res.json(json);
-  } catch (err) {
-    console.error("Proxy error:", err);
-    res.status(500).json({ error: "Failed to fetch forum data", details: String(err) });
-  }
-});
-
-app.listen(PORT, () => console.log(`Forum proxy running on port ${PORT}`));

From 4efaa8fc686c4fade76f729ae027a29291c86b6f Mon Sep 17 00:00:00 2001
From: Paul Gaikwad <gaikwadpaul05@gmail.com>
Date: Mon, 27 Oct 2025 14:59:15 +0100
Subject: [PATCH 06/10] Fixed fetch-faq.yml workflow

---
 .github/workflows/fetch-faq.yml | 53 +++++++++++++++++++++------------
 1 file changed, 34 insertions(+), 19 deletions(-)

diff --git a/.github/workflows/fetch-faq.yml b/.github/workflows/fetch-faq.yml
index 94acc956101..f954cd5d190 100644
--- a/.github/workflows/fetch-faq.yml
+++ b/.github/workflows/fetch-faq.yml
@@ -1,34 +1,49 @@
-name: Fetch FAQ Data
+name: Update Discourse data
 
 on:
+  workflow_dispatch:
   schedule:
-    - cron: "0 6 * * *"  # Every day at 6 AM UTC
-  workflow_dispatch:      # Allow manual run
+    - cron: "0 6 * * *"   # every day at 06:00 UTC
 
 jobs:
-  fetch-faq:
+  update-discourse-data:
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
 
     steps:
-      - name: Checkout repo
+      - name: Create GitHub App token
+        uses: actions/create-github-app-token@v1
+        id: app-token
+        with:
+          app-id: ${{ vars.WEBSITE_UPDATER_APPID }}
+          private-key: ${{ secrets.WEBSITE_UPDATER_KEY }}
+
+      - name: Checkout repository
         uses: actions/checkout@v4
+        with:
+          token: ${{ steps.app-token.outputs.token }}
 
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
+      - name: Set up Python
+        uses: actions/setup-python@v6
         with:
-          node-version: "18"
+          python-version: "3.14"
 
-      - name: Install dependencies
-        run: npm ci
+      - name: Fetch latest news from Discourse
+        run: python tools/fetch-news.py
 
-      - name: Fetch latest FAQ data from Discourse
-        run: node tools/fetch-faq.js
+      - name: Configure Git author
+        run: |
+          git config --local user.name "precice-bot"
+          git config --local user.email "info@precice.org"
 
-      - name: Commit and push changes
+      - name: Commit changes (if any)
         run: |
-          git config user.name "GitHub Actions"
-          git config user.email "actions@github.com"
-          git add assets/data/faq.json
-          git commit -m "ci(faq): update faq.json with latest excerpts from Discourse" || echo "No changes to commit"
-          git push origin HEAD:feature/faq-static-fetch
-        continue-on-error: true
+          git add assets/data/news.json
+          git commit -m "Update Discourse news data [skip ci]" || echo "No changes to commit"
+
+      - name: Push commit
+        uses: ad-m/github-push-action@master
+        with:
+          github_token: ${{ steps.app-token.outputs.token }}
+          branch: ${{ github.ref }}

From c65d753d7d7e31b8598419bc59e47e1122518c03 Mon Sep 17 00:00:00 2001
From: Paul Gaikwad <gaikwadpaul05@gmail.com>
Date: Mon, 27 Oct 2025 15:23:52 +0100
Subject: [PATCH 07/10] Added the Python File for Fetching

---
 tools/fetch-faq.py | 73 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)
 create mode 100644 tools/fetch-faq.py

diff --git a/tools/fetch-faq.py b/tools/fetch-faq.py
new file mode 100644
index 00000000000..abf9bf77b43
--- /dev/null
+++ b/tools/fetch-faq.py
@@ -0,0 +1,73 @@
+#!/usr/bin/env python3
+import os
+import json
+import re
+import requests
+from datetime import datetime
+
+DISCOURSE_BASE = "https://precice.discourse.group"
+OUTPUT_FILE = "./assets/data/faq.json"
+
+
+def strip_html(text: str) -> str:
+    return re.sub(r"<[^>]+>", "", text)
+
+
+def fetch_excerpt(topic_id: int) -> str:
+    try:
+        r = requests.get(f"{DISCOURSE_BASE}/t/{topic_id}.json")
+        r.raise_for_status()
+        topic_data = r.json()
+
+        raw = topic_data.get("post_stream", {}).get("posts", [{}])[0].get("cooked", "")
+        cleaned = strip_html(raw)
+        return cleaned[:250] + ("…" if len(cleaned) > 250 else "")
+    except Exception as e:
+        print(f"Could not fetch excerpt for topic {topic_id}: {e}")
+        return ""
+
+
+def fetch_faq():
+    try:
+        print("Fetching FAQ topics from Discourse...")
+        r = requests.get(f"{DISCOURSE_BASE}/tag/faq/l/latest.json")
+        r.raise_for_status()
+
+        json_data = r.json()
+        topic_list = json_data.get("topic_list", {}).get("topics", [])
+        print(f"Found {len(topic_list)} FAQ topics. Fetching excerpts...")
+
+        topics = []
+        for t in topic_list:
+            excerpt = fetch_excerpt(t["id"])
+            topics.append({
+                "id": t["id"],
+                "title": t["title"],
+                "slug": t["slug"],
+                "url": f"{DISCOURSE_BASE}/t/{t['slug']}/{t['id']}",
+                "created_at": t.get("created_at"),
+                "last_posted_at": t.get("last_posted_at"),
+                "views": t.get("views"),
+                "posts_count": t.get("posts_count"),
+                "like_count": t.get("like_count"),
+                "excerpt": excerpt,
+            })
+
+        payload = {
+            "source": "preCICE Discourse (FAQ)",
+            "generated_at": datetime.utcnow().isoformat(),
+            "topics": topics,
+        }
+
+        os.makedirs(os.path.dirname(OUTPUT_FILE), exist_ok=True)
+        with open(OUTPUT_FILE, "w", encoding="utf-8") as f:
+            json.dump(payload, f, indent=2)
+
+        print(f"Saved {len(topics)} FAQ topics to {OUTPUT_FILE}")
+    except Exception as e:
+        print("Failed to fetch FAQ data:", e)
+        exit(1)
+
+
+if __name__ == "__main__":
+    fetch_faq()

From eff0db6ee78735b91ad31f03fc8a6813b5f16bb5 Mon Sep 17 00:00:00 2001
From: Paul Gaikwad <gaikwadpaul05@gmail.com>
Date: Mon, 27 Oct 2025 23:13:07 +0100
Subject: [PATCH 08/10] Removed dependency on external library such as requests

---
 tools/fetch-faq.py | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/tools/fetch-faq.py b/tools/fetch-faq.py
index abf9bf77b43..ffa668a90e5 100644
--- a/tools/fetch-faq.py
+++ b/tools/fetch-faq.py
@@ -2,23 +2,26 @@
 import os
 import json
 import re
-import requests
+import urllib.request
 from datetime import datetime
 
 DISCOURSE_BASE = "https://precice.discourse.group"
 OUTPUT_FILE = "./assets/data/faq.json"
 
 
+def http_get_json(url: str):
+    """GET URL and return parsed JSON using only stdlib."""
+    with urllib.request.urlopen(url) as r:
+        return json.load(r)
+
+
 def strip_html(text: str) -> str:
     return re.sub(r"<[^>]+>", "", text)
 
 
 def fetch_excerpt(topic_id: int) -> str:
     try:
-        r = requests.get(f"{DISCOURSE_BASE}/t/{topic_id}.json")
-        r.raise_for_status()
-        topic_data = r.json()
-
+        topic_data = http_get_json(f"{DISCOURSE_BASE}/t/{topic_id}.json")
         raw = topic_data.get("post_stream", {}).get("posts", [{}])[0].get("cooked", "")
         cleaned = strip_html(raw)
         return cleaned[:250] + ("…" if len(cleaned) > 250 else "")
@@ -30,11 +33,9 @@ def fetch_excerpt(topic_id: int) -> str:
 def fetch_faq():
     try:
         print("Fetching FAQ topics from Discourse...")
-        r = requests.get(f"{DISCOURSE_BASE}/tag/faq/l/latest.json")
-        r.raise_for_status()
 
-        json_data = r.json()
-        topic_list = json_data.get("topic_list", {}).get("topics", [])
+        data = http_get_json(f"{DISCOURSE_BASE}/tag/faq/l/latest.json")
+        topic_list = data.get("topic_list", {}).get("topics", [])
         print(f"Found {len(topic_list)} FAQ topics. Fetching excerpts...")
 
         topics = []
@@ -64,6 +65,7 @@ def fetch_faq():
             json.dump(payload, f, indent=2)
 
         print(f"Saved {len(topics)} FAQ topics to {OUTPUT_FILE}")
+
     except Exception as e:
         print("Failed to fetch FAQ data:", e)
         exit(1)

From 086f07b23a4bb851f114b521a406e14c66c0973f Mon Sep 17 00:00:00 2001
From: Paul Gaikwad <gaikwadpaul05@gmail.com>
Date: Wed, 29 Oct 2025 00:52:24 +0100
Subject: [PATCH 09/10] Removed external link icon from FAQ Read more links
 using scoped CSS injection

---
 js/forum-fetch.js | 39 +++++++++++++++++++++++++++++----------
 1 file changed, 29 insertions(+), 10 deletions(-)

diff --git a/js/forum-fetch.js b/js/forum-fetch.js
index d8f9c723818..bfd8e3f953a 100644
--- a/js/forum-fetch.js
+++ b/js/forum-fetch.js
@@ -34,9 +34,7 @@ document.addEventListener("DOMContentLoaded", async function () {
 
       // Filter
       filteredTopics = topics.filter((t) =>
-        (t.title + " " + (t.excerpt || ""))
-          .toLowerCase()
-          .includes(q)
+        (t.title + " " + (t.excerpt || "")).toLowerCase().includes(q)
       );
 
       // Sort
@@ -69,13 +67,22 @@ document.addEventListener("DOMContentLoaded", async function () {
         card.style.cssText =
           "border:1px solid #ddd;padding:12px;border-radius:8px;background:#fff;";
 
+        const excerpt =
+          t.excerpt && t.excerpt.trim().length > 0
+            ? t.excerpt
+            : "No description available.";
+
         card.innerHTML = `
-          <h4>
-            <a href="${t.url}" target="_blank" rel="noopener noreferrer" style="text-decoration:none;color:#0069c2;">
-              ${t.title}
-            </a>
+          <h4 style="margin-bottom:8px;">
+            <strong>${t.title}</strong>
           </h4>
-          <p style="color:#333;">${t.excerpt || "No description available."}</p>
+          <p style="color:#333;line-height:1.4;">
+            ${excerpt}
+            <a href="${t.url}" target="_blank" rel="noopener noreferrer" 
+               style="text-decoration:none;color:#0069c2;" data-noicon>
+              Read more
+            </a>
+          </p>
           <p style="color:#666;font-size:0.9em;">
             Last updated: ${new Date(t.last_posted_at).toLocaleDateString()} |
             Replies: ${t.posts_count} | Views: ${t.views}
@@ -88,14 +95,26 @@ document.addEventListener("DOMContentLoaded", async function () {
         const btn = document.createElement("button");
         btn.textContent = "Load more";
         btn.style.cssText =
-      "padding:8px 16px;margin:12px 0 12px auto;display:block;border:1px solid #ccc;border-radius:8px;background:#f9f9f9;cursor:pointer;";
-
+          "padding:8px 16px;margin:12px 0 12px auto;display:block;border:1px solid #ccc;border-radius:8px;background:#f9f9f9;cursor:pointer;";
         btn.addEventListener("click", () => {
           visibleCount += 10;
           renderTopics();
         });
         list.appendChild(btn);
       }
+
+      // 🧽 JS-based CSS injection to remove external icon pseudo-element
+      if (!document.getElementById("noicon-style")) {
+        const style = document.createElement("style");
+        style.id = "noicon-style";
+        style.textContent = `
+          [data-noicon]::after {
+            content: none !important;
+            background-image: none !important;
+          }
+        `;
+        document.head.appendChild(style);
+      }
     }
 
     // Event listeners

From 90b7afc41435b1aa5425f7a417aded1425ea5560 Mon Sep 17 00:00:00 2001
From: Paul Gaikwad <gaikwadpaul05@gmail.com>
Date: Wed, 29 Oct 2025 15:05:14 +0100
Subject: [PATCH 10/10] Added Mobile Support for Displaying cards on small
 screens

---
 css/landing-page.css | 67 ++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 64 insertions(+), 3 deletions(-)

diff --git a/css/landing-page.css b/css/landing-page.css
index 8daedee5eae..0a173a86b6f 100644
--- a/css/landing-page.css
+++ b/css/landing-page.css
@@ -4,9 +4,6 @@
 /* clear fixes */
 /* idea is to not touch the docs part of the website, but start from a clear state */
 
-main { /* fixed topnav takes up 50 + 20 px */
-  /* margin-top: -20px; */
-}
 h1[id], h2[id], h3[id], h4[id], h5[id], h6[id],
 dt[id] {
 padding-top: 0px;
@@ -237,3 +234,67 @@ div.logo-holder > img {
 .no-padding {
   padding: 0;
 }
+
+/* Latest News Section */
+
+#latest-news {
+  background-color: #e6f2ff;
+  padding: 70px 0;
+}
+
+#latest-news .section-header {
+  margin-bottom: 40px;
+  text-align: center;
+}
+
+#latest-news a.no-external-marker::after {
+  content: none !important;
+}
+
+.news-card {
+  background: white;
+  border: 1px solid #ddd;
+  border-radius: 6px;
+  padding: 20px;
+  margin-bottom: 20px;
+  box-shadow: 0 2px 4px rgba(0,0,0,0.05);
+}
+
+.news-card h4 {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  line-clamp: 2; 
+  -webkit-box-orient: vertical;
+  height: 2.8em; 
+}
+
+.news-card p:first-of-type {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  display: -webkit-box;
+  -webkit-line-clamp: 4; 
+  line-clamp: 4;
+  -webkit-box-orient: vertical;
+}
+
+
+#news-container {
+  display: flex;
+  gap: 25px;
+}
+
+#news-container .col-md-4 {
+  flex: 1;
+}
+
+
+@media (max-width: 768px) {
+  #news-container {
+    flex-wrap: wrap;         
+  }
+  #news-container .col-md-4 {
+    flex: 1 1 100%;         
+  }
+}