diff --git a/README.md b/README.md
index 567bd1f..2423dc5 100644
--- a/README.md
+++ b/README.md
@@ -54,7 +54,8 @@ src/
 ├── assets/          # Images and static assets
 ├── components/      # Custom Astro components
 ├── content/docs/    # Documentation pages (Markdown/MDX)
-│   ├── usage/       # Getting started, configuration, plugins
+│   ├── usage/       # Getting started, configuration, running semantic-release
+│   ├── foundation/  # Concepts, constraints, and mental models of semantic-release
 │   ├── extending/   # Plugin and shareable configuration lists
 │   ├── recipes/     # CI configurations, git services, workflows
 │   ├── support/     # FAQ, troubleshooting, version requirements
@@ -76,4 +77,4 @@ To contribute to the docs:
 
 ## License
 
-This project is part of the [semantic-release](https://github.com/semantic-release/semantic-release) organization.
+This project is part of the [semantic-release](https://github.com/semantic-release) organization.
diff --git a/src/content/docs/recipes/git-hosted-services/index.md b/src/content/docs/recipes/git-hosted-services/index.md
deleted file mode 100644
index b83fa9c..0000000
--- a/src/content/docs/recipes/git-hosted-services/index.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-title: "Git hosted services"
----
-
-- [Git authentication with SSH keys](git-auth-ssh-keys)
diff --git a/src/content/docs/recipes/git-hosted-services/index.mdx b/src/content/docs/recipes/git-hosted-services/index.mdx
new file mode 100644
index 0000000..9b9e4b5
--- /dev/null
+++ b/src/content/docs/recipes/git-hosted-services/index.mdx
@@ -0,0 +1,13 @@
+---
+title: "Git hosted services"
+---
+
+import { CardGrid, LinkCard } from "@astrojs/starlight/components";
+
+<CardGrid>
+  <LinkCard
+    title="Git authentication with SSH keys"
+    href="/recipes/git-hosted-services/git-auth-ssh-keys/"
+    description="See how to configure Git authentication with SSH keys."
+  />
+</CardGrid>
diff --git a/src/content/docs/recipes/release-workflow/index.md b/src/content/docs/recipes/release-workflow/index.md
deleted file mode 100644
index 2f69a69..0000000
--- a/src/content/docs/recipes/release-workflow/index.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-title: "Release Workflow"
----
-
-- [Publishing on distribution channels](distribution-channels)
-- [Publishing maintenance releases](maintenance-releases)
-- [Publishing pre-releases](pre-releases)
diff --git a/src/content/docs/recipes/release-workflow/index.mdx b/src/content/docs/recipes/release-workflow/index.mdx
new file mode 100644
index 0000000..c3c1fea
--- /dev/null
+++ b/src/content/docs/recipes/release-workflow/index.mdx
@@ -0,0 +1,23 @@
+---
+title: "Release Workflow"
+---
+
+import { CardGrid, LinkCard } from "@astrojs/starlight/components";
+
+<CardGrid>
+  <LinkCard
+    title="Publishing on distribution channels"
+    href="/recipes/release-workflow/distribution-channels/"
+    description="See how to configure semantic-release to publish on distribution channels."
+  />
+  <LinkCard
+    title="Publishing maintenance releases"
+    href="/recipes/release-workflow/maintenance-releases/"
+    description="See how to configure semantic-release to publish maintenance releases."
+  />
+  <LinkCard
+    title="Publishing pre-releases"
+    href="/recipes/release-workflow/pre-releases/"
+    description="See how to configure semantic-release to publish pre-releases."
+  />
+</CardGrid>
diff --git a/tsconfig.json b/tsconfig.json
index 175e17c..0568a43 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -3,9 +3,8 @@
   "include": [".astro/types.d.ts", "**/*"],
   "exclude": ["dist"],
   "compilerOptions": {
-    "baseUrl": ".",
     "paths": {
-      "~/*": ["src/*"]
+      "~/*": ["./src/*"]
     }
   }
 }