refactor: recipe overview pages

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.

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>

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>

tsconfig.json

@@ -3,9 +3,8 @@
   "include": [".astro/types.d.ts", "**/*"],
   "exclude": ["dist"],
   "compilerOptions": {
-    "baseUrl": ".",
     "paths": {
-      "~/*": ["src/*"]
+      "~/*": ["./src/*"]
     }
   }
 }