From 9ece8400279574882e7edb28667786f5db042c60 Mon Sep 17 00:00:00 2001
From: Shahed Nasser <shahednasser@gmail.com>
Date: Mon, 7 Apr 2025 16:10:12 +0300
Subject: [PATCH] docs: fixes to content and UI (#12101)

---
 .../contribution-guidelines/docs/page.mdx          | 11 +++++++++++
 .../app/architectural-modules/locking/page.mdx     |  2 +-
 www/apps/ui/src/config/sidebar.tsx                 | 14 +++++++++++---
 3 files changed, 23 insertions(+), 4 deletions(-)

diff --git a/www/apps/book/app/learn/resources/contribution-guidelines/docs/page.mdx b/www/apps/book/app/learn/resources/contribution-guidelines/docs/page.mdx
index ce726a75c5..0357c71545 100644
--- a/www/apps/book/app/learn/resources/contribution-guidelines/docs/page.mdx
+++ b/www/apps/book/app/learn/resources/contribution-guidelines/docs/page.mdx
@@ -12,6 +12,17 @@ This guide is specific to contributing to the documentation. If you’re interes
 
 </Note>
 
+## What Can You Contribute?
+
+You can contribute to the Medusa documentation in the following ways:
+
+- Fixes to existing content. This includes small fixes like typos, or adding missing information.
+- Additions to the documentation. If you think a documentation page can be useful to other developers, you can contribute by adding it.
+    - Make sure to open an issue first in the [medusa repository](https://github.com/medusajs/medusa) to confirm that you can add that documentation page.
+- Fixes to UI components and tooling. If you find a bug while browsing the documentation, you can contribute by fixing it.
+
+---
+
 ## Documentation Workspace
 
 Medusa's documentation projects are all part of the documentation yarn workspace, which you can find in the [medusa repository](https://github.com/medusajs/medusa) under the `www` directory.
diff --git a/www/apps/resources/app/architectural-modules/locking/page.mdx b/www/apps/resources/app/architectural-modules/locking/page.mdx
index c14a9bbb2a..bebf61511f 100644
--- a/www/apps/resources/app/architectural-modules/locking/page.mdx
+++ b/www/apps/resources/app/architectural-modules/locking/page.mdx
@@ -140,7 +140,7 @@ When you register other providers in `medusa-config.ts`, Medusa will set the def
 
 ## List of Locking Module Providers
 
-Medusa provides the following Locking Module Providers. You can use one of them, or [Create a Locking Module Provider](./references/locking-module-provider).
+Medusa provides the following Locking Module Providers. You can use one of them, or [Create a Locking Module Provider](/references/locking-module-provider).
 
 <CardList
   items={[
diff --git a/www/apps/ui/src/config/sidebar.tsx b/www/apps/ui/src/config/sidebar.tsx
index 41edfe9787..a32d201413 100644
--- a/www/apps/ui/src/config/sidebar.tsx
+++ b/www/apps/ui/src/config/sidebar.tsx
@@ -53,11 +53,19 @@ export const sidebars: Sidebar.Sidebar[] = [
         ],
       },
       {
-        type: "link",
+        type: "category",
         title: "Icons",
-        path: "/icons/overview",
-        isPathHref: true,
         loaded: true,
+        initialOpen: true,
+        children: [
+          {
+            type: "link",
+            title: "Overview",
+            path: "/icons/overview",
+            isPathHref: true,
+            loaded: true,
+          },
+        ],
       },
       {
         type: "separator",