add references sidebar

www/apps/resources/sidebars/references.mjs

@@ -1,36 +1,45 @@
 /** @type {import('types').Sidebar.SidebarItem[]} */
 export const referencesSidebar = [
+  {
+    type: "link",
+    path: "/references-overview",
+    title: "Overview",
+  },
+  {
+    type: "separator",
+  },
+  {
+    type: "link",
+    path: "/admin-widget-injection-zones",
+    title: "Admin Widget Injection Zones",
+    description: "List of injection zones you can add widgets in.",
+  },
+  {
+    type: "link",
+    path: "/medusa-container-resources",
+    title: "Container Resources",
+    description:
+      "Resources you can access through the Medusa and Module containers.",
+  },
   {
     type: "sidebar",
-    sidebar_id: "workflows-sdk-reference",
-    title: "Workflows SDK",
-    childSidebarTitle: "Workflows SDK Reference",
-    children: [
-      {
-        type: "link",
-        path: "/references/workflows",
-        title: "Reference Overview",
-      },
-      {
-        type: "separator",
-      },
-      {
-        type: "category",
-        title: "Functions",
-        autogenerate_path: "/references/workflows/functions",
-      },
-    ],
+    sidebar_id: "core-flows",
+    title: "Core Workflows",
+    custom_autogenerate: "core-flows",
+    description:
+      "Built-in workflows and steps you can use in your customizations.",
   },
   {
     type: "sidebar",
     sidebar_id: "dml-reference",
     title: "Data Model Language",
     childSidebarTitle: "Data Model Language Reference",
+    description: "API reference of the Data Model Langauge (DML).",
     children: [
       {
         type: "link",
         path: "/references/data-model",
-        title: "Reference Overview",
+        title: "Overview",
       },
       {
         type: "separator",
@@ -66,15 +75,44 @@ export const referencesSidebar = [
       },
     ],
   },
+  {
+    type: "link",
+    path: "/events-reference",
+    title: "Events",
+    description: "List of events emitted by Medusa's Commerce Modules.",
+  },
+  {
+    type: "sidebar",
+    sidebar_id: "helper-steps-reference",
+    title: "Helper Steps",
+    description: "Steps to query data, emit events, create links, and more.",
+    children: [
+      {
+        type: "link",
+        path: "/references/helper-steps",
+        title: "Overview",
+      },
+      {
+        type: "separator",
+      },
+      {
+        type: "category",
+        title: "Steps",
+        autogenerate_path: "/references/helper_steps/functions",
+      },
+    ],
+  },
   {
     type: "sidebar",
     sidebar_id: "service-factory-reference",
     title: "Service Factory",
+    description:
+      "List of methods in your service extending the service factory.",
     children: [
       {
         type: "link",
         path: "/service-factory-reference",
-        title: "Reference Overview",
+        title: "Overview",
       },
       {
         type: "separator",
@@ -91,41 +129,16 @@ export const referencesSidebar = [
       },
     ],
   },
-  {
-    type: "sidebar",
-    sidebar_id: "helper-steps-reference",
-    title: "Helper Steps",
-    children: [
-      {
-        type: "link",
-        path: "/references/helper-steps",
-        title: "Reference Overview",
-      },
-      {
-        type: "separator",
-      },
-      {
-        type: "category",
-        title: "Steps",
-        autogenerate_path: "/references/helper_steps/functions",
-      },
-    ],
-  },
-  {
-    type: "sidebar",
-    sidebar_id: "core-flows",
-    title: "Core Workflows",
-    custom_autogenerate: "core-flows",
-  },
   {
     type: "sidebar",
     sidebar_id: "test-tools-reference",
     title: "Testing Framework",
+    description: "API reference of functions you can use to write tests.",
     children: [
       {
         type: "link",
         path: "/test-tools-reference",
-        title: "Reference Overview",
+        title: "Overview",
       },
       {
         type: "separator",
@@ -148,4 +161,26 @@ export const referencesSidebar = [
       },
     ],
   },
+  {
+    type: "sidebar",
+    sidebar_id: "workflows-sdk-reference",
+    title: "Workflows SDK",
+    childSidebarTitle: "Workflows SDK Reference",
+    description: "API reference of the Workflow SDK functions and helpers.",
+    children: [
+      {
+        type: "link",
+        path: "/references/workflows",
+        title: "Overview",
+      },
+      {
+        type: "separator",
+      },
+      {
+        type: "category",
+        title: "Functions",
+        autogenerate_path: "/references/workflows/functions",
+      },
+    ],
+  },
 ]