diff --git a/docs/src/components/DirectoryLinks.astro b/docs/src/components/DirectoryLinks.astro
index 1566aeecb9..7137420f36 100644
--- a/docs/src/components/DirectoryLinks.astro
+++ b/docs/src/components/DirectoryLinks.astro
@@ -10,6 +10,7 @@ const { directory } = Astro.props
 const pages = (
     await getCollection("docs", (entry) => entry.id.startsWith(directory + "/"))
 ).filter(({ slug }) => slug !== directory)
+.sort((a, b) => (a.data.sidebar.order ?? 0) - (b.data.sidebar.order ?? 0))
 ---
 
 <CardGrid
diff --git a/docs/src/content/docs/blog/automatic-web-page-content-analysis-with-genaiscript-.md b/docs/src/content/docs/blog/automatic-web-page-content-analysis-with-genaiscript-.md
index 0579f8a7e6..f5a6c6cdf3 100644
--- a/docs/src/content/docs/blog/automatic-web-page-content-analysis-with-genaiscript-.md
+++ b/docs/src/content/docs/blog/automatic-web-page-content-analysis-with-genaiscript-.md
@@ -1,12 +1,13 @@
 ---
 title: Automatic Web Page Content Analysis
 date: 2024-09-12
-authors: [genaiscript, pelikhan]
-tags:
-    - GenAIScript
-    - Web Content Analysis
-    - Automation
-    - AI
+authors:
+  - genaiscript
+  - pelikhan
+tags: content analysis, playwright, automation, GenAIScript, web
+description: Learn how GenAIScript leverages the Playwright browser automation
+  library for efficient, automated analysis of web page content.
+
 ---
 
 In this blog post, we'll dive into a practical example showcasing how to leverage GenAIScript for automatic web page content analysis. GenAIScript uses the [playwright](https://playwright.dev/) browser automation library which allows to load, interact and inspect web pages.
diff --git a/docs/src/content/docs/blog/drafts/automate-git-commit-messages-with-genai.md b/docs/src/content/docs/blog/drafts/automate-git-commit-messages-with-genai.md
index 9b8c67dcb5..348d71ab7c 100644
--- a/docs/src/content/docs/blog/drafts/automate-git-commit-messages-with-genai.md
+++ b/docs/src/content/docs/blog/drafts/automate-git-commit-messages-with-genai.md
@@ -1,10 +1,13 @@
 ---
-title: "Automate Git Commit Messages with GenAI"
+title: Automate Git Commit Messages with GenAI
 date: 2024-09-19
 draft: true
-tags: ["genai", "git", "automation", "typescript"]
+tags: git, typescript, productivity, automation
 authors: genaiscript
 canonical_url: https://microsoft.github.io/genaiscript/blog/automate-git-commit-messages-with-genai
+description: Discover how GenAI simplifies your Git workflow by automating
+  commit message generation based on your staged changes.
+
 ---
 
 ## Simplifying Your Git Workflow with GenAI
diff --git a/docs/src/content/docs/blog/drafts/code-review-with-genai.md b/docs/src/content/docs/blog/drafts/code-review-with-genai.md
index b4b6d7bba8..8c7512bd39 100644
--- a/docs/src/content/docs/blog/drafts/code-review-with-genai.md
+++ b/docs/src/content/docs/blog/drafts/code-review-with-genai.md
@@ -1,10 +1,13 @@
 ---
-title: "Code Review with GenAI"
+title: Code Review with GenAI
 date: 2024-09-19
 draft: true
-tags: ["GenAI", "Code Review", "Programming", "Development", "Automation"]
+tags: code review, development, programming, automation
 authors: genaiscript
 canonical_url: https://microsoft.github.io/genaiscript/blog/code-review-with-genai
+description: Dive into automated code review processes with GenAI, enhancing
+  developer efficiency and code quality.
+
 ---
 
 ## Introducing "Code Review with GenAI" 🧐
diff --git a/docs/src/content/docs/blog/search-transform-genai.md b/docs/src/content/docs/blog/search-transform-genai.md
index cf51084f4e..af2399b16e 100644
--- a/docs/src/content/docs/blog/search-transform-genai.md
+++ b/docs/src/content/docs/blog/search-transform-genai.md
@@ -1,9 +1,12 @@
 ---
-title: "Search and Transform"
+title: Search and Transform
 date: 2024-09-24
 authors: genaiscript
-tags: ["genai", "scripting", "automation"]
+tags: search, transform, automation, scripting, productivity
 canonical_url: https://microsoft.github.io/genaiscript/blog/search-transform-genai
+description: Explore how GenAIScript automates the search and transformation of
+  patterns across multiple files, enhancing efficiency in development tasks.
+
 ---
 
 Have you ever found yourself in a situation where you need to search through multiple files in your project, find a specific pattern, and then apply a transformation to it? It can be a tedious task, but fear not! In this blog post, I'll walk you through a GenAIScript that does just that, automating the process and saving you time. 🕒💡