fix(docs): restore /docs entrypoint and correct docs links

Author: danielgorgonha

astro.config.mjs

@@ -20,29 +20,29 @@ export default defineConfig({
         {
           label: 'Getting Started',
           items: [
-            { label: 'Introduction', link: '/docs/' },
-            { label: 'Installation', link: '/docs/getting-started/installation/' },
-            { label: 'Configuration', link: '/docs/getting-started/configuration/' },
+            { label: 'Introduction', link: '/' },
+            { label: 'Installation', link: '/getting-started/installation/' },
+            { label: 'Configuration', link: '/getting-started/configuration/' },
           ],
         },
         {
           label: 'Guides',
           items: [
-            { label: 'Your First Agent', link: '/docs/guides/first-agent/' },
-            { label: 'Customization', link: '/docs/guides/customization/' },
+            { label: 'Your First Agent', link: '/guides/first-agent/' },
+            { label: 'Customization', link: '/guides/customization/' },
           ],
         },
         {
           label: 'Reference',
           items: [
-            { label: 'Scripts', link: '/docs/reference/scripts/' },
-            { label: 'Docker', link: '/docs/reference/docker/' },
-            { label: 'Environment Variables', link: '/docs/reference/environment/' },
+            { label: 'Scripts', link: '/reference/scripts/' },
+            { label: 'Docker', link: '/reference/docker/' },
+            { label: 'Environment Variables', link: '/reference/environment/' },
           ],
         },
         {
           label: 'Contributing',
-          link: '/docs/contributing/',
+          link: '/contributing/',
         },
       ],
       head: [

src/content/docs/index.mdx

@@ -40,15 +40,15 @@ openclaw onboard
 
 <CardGrid>
   <Card title="Installation" icon="rocket">
-    [Detailed installation guide](/docs/getting-started/installation/)
+    [Detailed installation guide](/getting-started/installation/)
   </Card>
   <Card title="Configuration" icon="setting">
-    [Configure your environment](/docs/getting-started/configuration/)
+    [Configure your environment](/getting-started/configuration/)
   </Card>
   <Card title="First Agent" icon="pencil">
-    [Create your first agent](/docs/guides/first-agent/)
+    [Create your first agent](/guides/first-agent/)
   </Card>
   <Card title="Reference" icon="open-book">
-    [Scripts and Docker reference](/docs/reference/scripts/)
+    [Scripts and Docker reference](/reference/scripts/)
   </Card>
 </CardGrid>

src/pages/docs.astro

@@ -0,0 +1,38 @@
+---
+import Layout from '../layouts/Layout.astro';
+---
+
+<Layout title="ClawHalla Docs">
+  <main class="min-h-screen bg-dark text-gray-200 px-4 py-16">
+    <section class="max-w-4xl mx-auto">
+      <h1 class="font-heading text-4xl md:text-5xl font-bold mb-4">
+        <span class="text-primary">ClawHalla</span> Documentation
+      </h1>
+      <p class="text-gray-400 mb-10">
+        Start here, then continue to the full Starlight sections.
+      </p>
+
+      <div class="grid md:grid-cols-2 gap-4">
+        <a href="/getting-started/installation/" class="p-5 rounded-lg border border-dark-200 hover:border-primary/40 transition-colors">
+          <h2 class="font-heading text-xl text-primary mb-1">Installation</h2>
+          <p class="text-gray-400 text-sm">Install ClawHalla and run your first onboarding.</p>
+        </a>
+
+        <a href="/getting-started/configuration/" class="p-5 rounded-lg border border-dark-200 hover:border-primary/40 transition-colors">
+          <h2 class="font-heading text-xl text-primary mb-1">Configuration</h2>
+          <p class="text-gray-400 text-sm">Set environment variables and onboarding preferences.</p>
+        </a>
+
+        <a href="/guides/first-agent/" class="p-5 rounded-lg border border-dark-200 hover:border-primary/40 transition-colors">
+          <h2 class="font-heading text-xl text-primary mb-1">Your First Agent</h2>
+          <p class="text-gray-400 text-sm">Bring your first OpenClaw agent online.</p>
+        </a>
+
+        <a href="/reference/scripts/" class="p-5 rounded-lg border border-dark-200 hover:border-primary/40 transition-colors">
+          <h2 class="font-heading text-xl text-primary mb-1">Reference</h2>
+          <p class="text-gray-400 text-sm">Scripts, Docker, and environment variable reference.</p>
+        </a>
+      </div>
+    </section>
+  </main>
+</Layout>