fix: resolve broken links and create dedicated core concept pages

- Fix broken links:
  - Update Footer GitHub link from generic to project-specific
  - Change Footer "API Reference" label to "Documentation"
  - Fix all /docs/createMachine/ links to /docs/createmachine/ (lowercase)
  - Remove broken robot/debug link reference
  - Ensure all doc links have trailing slashes

- Create dedicated core concept pages:
  - Add concepts-state.md - Understanding State in FSMs
  - Add concepts-transitions.md - Understanding Transitions
  - Add concepts-events.md - Understanding Events
  - Add concepts-guards.md - Understanding Guards
  - Add concepts-actions.md - Understanding Actions

- Update core-concepts.md to serve as overview page with links to detailed concept pages
- Update DocsSidebar to link to new individual concept pages instead of hash sections

Fixes #249

Author: matthewp

docs/astro.config.mjs

@@ -9,5 +9,8 @@ export default defineConfig({
   },
   markdown: {
     syntaxHighlight: 'prism'
+  },
+  server: {
+    host: '0.0.0.0'
   }
 });

docs/src/components/DocsSidebar.astro

@@ -7,11 +7,11 @@ const activeItem = undefined;
   const sections = {
     'CORE_CONCEPTS': [
       { title: "Overview", id: "overview", slug: "core-concepts" },
-      { title: "STATE", id: "state", slug: "core-concepts", hash: "#state" },
-      { title: "TRANSITIONS", id: "transitions", slug: "core-concepts", hash: "#transitions" },
-      { title: "EVENTS", id: "events", slug: "core-concepts", hash: "#events" },
-      { title: "GUARDS", id: "guards", slug: "core-concepts", hash: "#guards" },
-      { title: "ACTIONS", id: "actions", slug: "core-concepts", hash: "#actions" }
+      { title: "STATE", id: "state", slug: "concepts-state" },
+      { title: "TRANSITIONS", id: "transitions", slug: "concepts-transitions" },
+      { title: "EVENTS", id: "events", slug: "concepts-events" },
+      { title: "GUARDS", id: "guards", slug: "concepts-guards" },
+      { title: "ACTIONS", id: "actions", slug: "concepts-actions" }
     ],
     'GUIDES': [
       { title: "COMPOSITION", id: "composition", slug: "composition" },

docs/src/components/Footer.astro

@@ -8,7 +8,7 @@ import Heart from '../icons/Heart.astro';
       <div>
         <h3 class="font-mono text-cyan-400 font-bold mb-4 text-sm">CONNECT</h3>
         <div class="space-y-2">
-          <a href="https://github.com" class="flex items-center justify-center gap-2 text-gray-200 hover:text-cyan-400 transition-colors">
+          <a href="https://github.com/matthewp/robot" class="flex items-center justify-center gap-2 text-gray-200 hover:text-cyan-400 transition-colors">
             <Github size={16} />
             <span>GitHub</span>
           </a>
@@ -18,7 +18,7 @@ import Heart from '../icons/Heart.astro';
       <div>
         <h3 class="font-mono text-cyan-400 font-bold mb-4 text-sm">DOCS</h3>
         <div class="space-y-2">
-          <a href="/docs/" class="block text-gray-200 hover:text-cyan-400 transition-colors">API Reference</a>
+          <a href="/docs/" class="block text-gray-200 hover:text-cyan-400 transition-colors">Documentation</a>
         </div>
       </div>