docs: update release-note documentation to include version bump and GitHub Release process

- Enhanced the release-note documentation to clarify the steps for version bumping, committing changes, tagging, and creating a GitHub Release.
- Added detailed instructions for user confirmation and the final release note output.
- Updated the changelog section to reflect the final release content and requirements for using the `gh` CLI.

Author: kingRayhan

.agents/skills/release-note/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: release-note
-description: Generate a semver-compliant release note from git history
+description: Generate a semver-compliant release note from git history; on user confirmation, bump version, update CHANGELOG, create git tag, and publish a GitHub Release with gh
 user-invocable: true
 ---
 
-Generate a release note for this project following https://semver.org/.
+Generate a release note for this project following https://semver.org/. When the user **confirms** the version, also **commit** (if needed), **tag**, **push the tag**, and **`gh release create`** using the final notes as the release description.
 
 ## Steps
 
@@ -75,15 +75,17 @@ Omit empty sections.
 After the draft, ask the user:
 
 > **Does `v<next>` look right?**
-> - Confirm → finalize and print the clean release note
+> - **Confirm** → finalize files, **create git tag**, **create GitHub Release** with the release notes as the description (see step 7)
 > - Provide a different version (e.g. `v2.0.0`) → reformat with that version
-> - Cancel → discard
+> - **Cancel** → discard (no file writes, no tag, no release)
 
-Once confirmed:
+### 7. After confirmation — files, tag, and GitHub Release
 
-1. **Update `package.json`** — read the file, set `"version"` to the confirmed version (without the `v` prefix, e.g. `"1.3.0"`), and write it back.
+Use the **confirmed** version as `v<next>` (e.g. `v0.4.0`). The **final release body** is the same content as in `CHANGELOG.md` for that version: title `## Release v<next> — <YYYY-MM-DD>` plus sections (omit empty ones). Do **not** include the draft-only line `> Suggested bump: ...`.
 
-2. **Update `CHANGELOG.md`** — prepend the new release section (without the `> Suggested bump:` line) to the top of the entries in `CHANGELOG.md`. If the file doesn't exist, create it with a standard header:
+1. **Update `package.json`** — set `"version"` to the semver without `v` (e.g. `"0.4.0"`).
+
+2. **Update `CHANGELOG.md`** — prepend the final release section (same as the GitHub Release description). If the file does not exist, create it with:
    ```markdown
    # Changelog
 
@@ -93,6 +95,39 @@ Once confirmed:
 
    ---
    ```
-   Then append the release section below the `---` separator.
 
-3. **Output the final release note** ready to paste into a GitHub Release or PR description.
+3. **Commit** the version bump and changelog (if the repo should record the release commit before tagging):
+   ```bash
+   git add package.json CHANGELOG.md
+   git commit -m "chore(release): v<next>"
+   git push origin HEAD
+   ```
+   Skip commit/push only if the user already committed these changes or explicitly asks not to.
+
+4. **Create an annotated tag** at the release commit:
+   ```bash
+   git tag -a "v<next>" -m "Release v<next>"
+   git push origin "v<next>"
+   ```
+   If the tag already exists locally or on the remote, stop and resolve (delete mistaken tag or bump version) before continuing.
+
+5. **Create the GitHub Release** with the same notes as `CHANGELOG` for this version:
+   ```bash
+   # Write the final body to a temp file, then:
+   gh release create "v<next>" --title "Release v<next>" --notes-file /tmp/release-v<next>.md
+   ```
+   Alternatively pass `--notes` with the full markdown string. Do not use `--generate-notes` if you want the curated changelog to match `CHANGELOG.md`.
+
+   Requirements: `gh` CLI authenticated (`gh auth status`), and permission to create releases on the repo.
+
+6. **Output** the final release note in chat for the user’s records (same text as in the Release description).
+
+#### If `gh release create` should create the tag (alternative)
+
+Some teams skip the local annotated tag and let GitHub create the tag from the default branch when publishing the release:
+
+```bash
+gh release create "v<next>" --title "Release v<next>" --notes-file /tmp/release-v<next>.md --target <branch>
+```
+
+Prefer the **annotated tag + push + `gh release create`** flow (steps 4–5) so the tag exists locally and matches the release commit; use `--target` only when aligning with a specific branch policy.

src/app/rss/articles/route.ts

@@ -0,0 +1,111 @@
+import type { Article, User } from "@/backend/models/domain-models";
+import { persistenceRepository } from "@/backend/persistence/persistence-repositories";
+import { DatabaseTableName } from "@/backend/persistence/persistence-contracts";
+import { markdocToHtmlForRss } from "@/lib/markdown/markdoc-html-string";
+import getFileUrl from "@/utils/getFileUrl";
+import * as sk from "sqlkit";
+import { and, desc, neq } from "sqlkit";
+
+const RSS_ITEM_LIMIT = 100;
+
+function escapeXml(text: string): string {
+  return text
+    .replace(/&/g, "&")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&apos;");
+}
+
+function rfc822Date(d: Date): string {
+  return d.toUTCString();
+}
+
+export async function GET(request: Request) {
+  const feedUrl = new URL(request.url);
+  const siteUrl = feedUrl.origin;
+
+  const { nodes } = await persistenceRepository.article.paginate({
+    where: and(neq("published_at", null), neq("approved_at", null)),
+    page: 1,
+    limit: RSS_ITEM_LIMIT,
+    orderBy: [desc("published_at")],
+    columns: [
+      "id",
+      "title",
+      "handle",
+      "body",
+      "cover_image",
+      "published_at",
+      "created_at",
+      "updated_at",
+    ],
+    joins: [
+      {
+        as: "user",
+        table: DatabaseTableName.users,
+        type: "left",
+        on: {
+          foreignField: "id",
+          localField: "author_id",
+        },
+        columns: ["id", "name", "username"],
+      } as sk.Join<Article, User>,
+    ],
+  });
+
+  const articles = nodes.filter((a) => a.handle && a.user?.username);
+  const now = new Date();
+
+  const channelItems = articles
+    .map((article) => {
+      const username = article.user!.username!;
+      const href = `${siteUrl}/@${username}/${article.handle}`;
+      const pub = article.published_at ?? article.created_at ?? now;
+
+      const author =
+        article.user?.name?.trim() || (username ? `@${username}` : "TechDiary");
+
+      const coverSrc = article.cover_image
+        ? getFileUrl(article.cover_image).trim()
+        : "";
+      const mediaThumb =
+        coverSrc !== ""
+          ? `\n      <media:thumbnail url="${escapeXml(coverSrc)}" />`
+          : "";
+
+      return `    <item>
+      <title>${escapeXml(article.title)}</title>
+      <link>${escapeXml(href)}</link>
+      <guid isPermaLink="true">${escapeXml(href)}</guid>
+      <pubDate>${rfc822Date(pub)}</pubDate>
+      <dc:creator>${escapeXml(author)}</dc:creator>${mediaThumb}
+      <description><![CDATA[${markdocToHtmlForRss(article.body, {
+        featureImageUrl: coverSrc || undefined,
+        featureImageAlt: article.title,
+      })}]]></description>
+    </item>`;
+    })
+    .join("\n");
+
+  const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:media="http://search.yahoo.com/mrss/">
+  <channel>
+    <title>TechDiary — Articles</title>
+    <link>${escapeXml(siteUrl)}</link>
+    <description>Latest published articles on TechDiary</description>
+    <language>bn-bd</language>
+    <lastBuildDate>${rfc822Date(now)}</lastBuildDate>
+    <atom:link href="${escapeXml(feedUrl.href)}" rel="self" type="application/rss+xml"/>
+${channelItems}
+  </channel>
+</rss>
+`;
+
+  return new Response(xml, {
+    headers: {
+      "Content-Type": "application/rss+xml; charset=utf-8",
+      "Cache-Control": "public, s-maxage=300, stale-while-revalidate=600",
+    },
+  });
+}

src/components/widgets/SocialLinksWidget.tsx

@@ -57,7 +57,7 @@ const SocialLinksWidget = () => {
         </a>
 
         <a
-          href="/sitemaps/articles/sitemap.xml"
+          href="/rss/articles"
           target="_blank"
           rel="nofollow"
           className="text-foreground flex items-center space-x-2"

src/lib/markdown/markdoc-html-string.ts

@@ -0,0 +1,83 @@
+import Markdoc, { type Node, Tag } from "@markdoc/markdoc";
+import { removeMarkdownSyntax } from "@/lib/utils";
+
+function safeForCdata(html: string): string {
+  return html.replace(/]]>/g, "]]]]><![CDATA[>");
+}
+
+function escapeHtmlAttr(s: string): string {
+  return s
+    .replace(/&/g, "&amp;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#39;")
+    .replace(/</g, "&lt;");
+}
+
+function escapeHtmlText(s: string): string {
+  return s
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;");
+}
+
+function featureImageMarkup(url: string, alt: string): string {
+  return `<figure class="rss-feature-image"><img src="${escapeHtmlAttr(url)}" alt="${escapeHtmlAttr(alt)}" /></figure>`;
+}
+
+export type MarkdocRssOptions = {
+  featureImageUrl?: string | null;
+  featureImageAlt?: string;
+};
+
+/**
+ * Renders article Markdoc to an HTML string for RSS (no React / react-dom/server).
+ * Uses Markdoc’s HTML renderer; custom tags match site features where useful.
+ */
+export function markdocToHtmlForRss(
+  body: string | null | undefined,
+  opts?: MarkdocRssOptions,
+): string {
+  const md = body ?? "";
+  const alt = opts?.featureImageAlt ?? "";
+  const featureUrl = opts?.featureImageUrl?.trim();
+  const prefix = featureUrl ? featureImageMarkup(featureUrl, alt) : "";
+
+  try {
+    const ast = Markdoc.parse(md);
+    const content = Markdoc.transform(ast, {
+      tags: {
+        youtube: {
+          attributes: {
+            id: { type: String, required: true },
+          },
+          transform(node: Node) {
+            return new Tag("iframe", {
+              src: `https://www.youtube.com/embed/${node.attributes.id}`,
+              width: "560",
+              height: "315",
+              title: "YouTube video",
+              allow:
+                "accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture",
+              allowfullscreen: "true",
+            });
+          },
+        },
+        livecode: {
+          attributes: {
+            template: { type: String, default: "react" },
+            content: { type: String, required: true },
+          },
+          transform(node: Node) {
+            return new Tag("pre", { class: "livecode-rss" }, [
+              node.attributes.content as string,
+            ]);
+          },
+        },
+      },
+    });
+    return safeForCdata(prefix + Markdoc.renderers.html(content));
+  } catch {
+    const text = removeMarkdownSyntax(md, 200) ?? "";
+    return safeForCdata(`${prefix}<p>${escapeHtmlText(text)}</p>`);
+  }
+}