Subscriptions overhaul

.github/workflows/ci.yml

@@ -10,4 +10,5 @@ jobs:
     - name: Lychee Broken Link Checker
       uses: lycheeverse/lychee-action@v2.9.0
       with:
+	args: --root-dir "$(pwd)/src/content/docs" --verbose --no-progress './**/*.md' './**/*.mdx'
         fail: true

.vale.ini

@@ -1,6 +1,8 @@
 StylesPath = styles
 MinAlertLevel = error
 
+Vocab = OPA
+
 Packages = Google, write-good, MDX
 
 [*.{md,mdx}]

astro.config.ts

@@ -1,8 +1,18 @@
 import { defineConfig } from "astro/config";
+import { satteri } from '@astrojs/markdown-satteri';
 import starlight from "@astrojs/starlight";
 import starlightOpenAPI, { openAPISidebarGroups } from 'starlight-openapi'
 
 export default defineConfig({
+  markdown: {
+    processor: satteri({
+      features: {
+	gfm: true,
+	headingAttributes: true,
+	directive: true,
+      },
+    })
+  },
   integrations: [
     starlight({
       title: "Open Podcast API",
@@ -41,14 +51,29 @@ export default defineConfig({
               label: "Introduction",
               link: "specs",
             },
+	    {
+	      label: "Conventions",
+	      link: "specs/conventions"
+	    },
+	    {
+	      label: "Authentication",
+	      link: "specs/authentication"
+	    },
+	    {
+	      label: "Synchronization",
+	      link: "specs/sync",
+	      badge: {
+		text: "Core",
+		variant: "success"
+	      }
+	    },
             {
               label: "Subscriptions",
-              collapsed: true,
-              items: [{
-                autogenerate: {
-                  directory: "specs/subscriptions",
-                }
-              }],
+              link: "specs/subscriptions",
+	      badge: {
+		text: 'Core',
+		variant: 'success'
+	      }
             },
           ],
         },