docs: added product review guide (#11852)

* finish guide

* fix tags not showing correctly

* revert changes in prepare

* generate changes

www/apps/book/scripts/prepare.mjs

@@ -110,6 +110,24 @@ async function main() {
       {
         dir: path.join(process.cwd(), "..", "resources", "app", "js-sdk"),
       },
+      {
+        dir: path.join(process.cwd(), "..", "resources", "app", "examples"),
+      },
+      {
+        dir: path.join(
+          process.cwd(),
+          "..",
+          "resources",
+          "app",
+          "how-to-tutorials"
+        ),
+      },
+      {
+        dir: path.join(process.cwd(), "..", "resources", "app", "integrations"),
+      },
+      {
+        dir: path.join(process.cwd(), "..", "resources", "app", "plugins"),
+      },
       {
         dir: path.join(
           process.cwd(),

www/apps/resources/generated/edit-dates.mjs

@@ -6044,9 +6044,9 @@ export const generatedEditDates = {
   "app/how-to-tutorials/page.mdx": "2025-03-10T09:33:49.208Z",
   "app/tools/page.mdx": "2025-03-10T12:38:56.520Z",
   "app/references-overview/page.mdx": "2025-03-10T12:55:49.803Z",
-  "app/architectural-modules/locking/page.mdx": "2025-03-12T11:40:25.695Z",
+  "app/architectural-modules/locking/page.mdx": "2025-03-14T08:32:57.875Z",
-  "app/architectural-modules/locking/postgres/page.mdx": "2025-03-12T10:07:48.820Z",
+  "app/architectural-modules/locking/postgres/page.mdx": "2025-03-14T08:32:57.875Z",
-  "app/architectural-modules/locking/redis/page.mdx": "2025-03-12T10:07:43.867Z",
+  "app/architectural-modules/locking/redis/page.mdx": "2025-03-14T08:32:57.876Z",
   "references/locking/interfaces/locking.ILockingModule/page.mdx": "2025-03-12T12:28:30.425Z",
   "references/locking/interfaces/locking.ILockingProvider/page.mdx": "2025-03-12T12:28:30.422Z",
   "references/modules/locking/page.mdx": "2025-03-12T12:28:30.419Z",
@@ -6060,5 +6060,6 @@ export const generatedEditDates = {
   "references/notification_service/interfaces/notification_service.INotificationModuleService/page.mdx": "2025-03-17T15:24:05.173Z",
   "app/nextjs-starter/guides/revalidate-cache/page.mdx": "2025-03-18T08:47:59.628Z",
   "app/storefront-development/cart/totals/page.mdx": "2025-03-18T09:20:59.533Z",
-  "app/storefront-development/checkout/order-confirmation/page.mdx": "2025-03-18T09:44:14.561Z"
+  "app/storefront-development/checkout/order-confirmation/page.mdx": "2025-03-18T09:44:14.561Z",
+  "app/how-to-tutorials/tutorials/product-reviews/page.mdx": "2025-03-19T13:00:56.901Z"
 }

www/apps/resources/generated/files-map.mjs

@@ -815,6 +815,10 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/how-to-tutorials/page.mdx",
     "pathname": "/how-to-tutorials"
   },
+  {
+    "filePath": "/www/apps/resources/app/how-to-tutorials/tutorials/product-reviews/page.mdx",
+    "pathname": "/how-to-tutorials/tutorials/product-reviews"
+  },
   {
     "filePath": "/www/apps/resources/app/integrations/guides/resend/page.mdx",
     "pathname": "/integrations/guides/resend"

www/apps/resources/generated/generated-commerce-modules-sidebar.mjs

@@ -3373,7 +3373,7 @@ const generatedgeneratedCommerceModulesSidebarSidebar = {
           "isPathHref": true,
           "type": "category",
           "title": "Admin User Guides",
-          "autogenerate_tags": "userGuide+fulfillment",
+          "autogenerate_tags": "fulfillment+userGuide",
           "autogenerate_as_ref": true,
           "sort_sidebar": "alphabetize",
           "description": "Learn how to utilize and manage Fulfillment features in the Medusa Admin dashboard.",
@@ -3394,6 +3394,14 @@ const generatedgeneratedCommerceModulesSidebarSidebar = {
               "path": "https://docs.medusajs.com/user-guide/orders/fulfillments",
               "children": []
             },
+            {
+              "loaded": true,
+              "isPathHref": true,
+              "type": "ref",
+              "title": "Manage Shipping Options",
+              "path": "https://docs.medusajs.com/user-guide/settings/locations-and-shipping/locations",
+              "children": []
+            },
             {
               "loaded": true,
               "isPathHref": true,
@@ -11011,7 +11019,7 @@ const generatedgeneratedCommerceModulesSidebarSidebar = {
           "isPathHref": true,
           "type": "category",
           "title": "Server Guides",
-          "autogenerate_tags": "server+product",
+          "autogenerate_tags": "product+server",
           "autogenerate_as_ref": true,
           "sort_sidebar": "alphabetize",
           "description": "Learn how to use the Product Module in your customizations on the Medusa application server.",
@@ -11047,6 +11055,14 @@ const generatedgeneratedCommerceModulesSidebarSidebar = {
               "path": "/commerce-modules/product/guides/price",
               "title": "Get Variant Prices",
               "children": []
+            },
+            {
+              "loaded": true,
+              "isPathHref": true,
+              "type": "ref",
+              "title": "Implement Product Reviews",
+              "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/product-reviews",
+              "children": []
             }
           ]
         },

www/apps/resources/generated/generated-how-to-tutorials-sidebar.mjs

@@ -349,6 +349,15 @@ const generatedgeneratedHowToTutorialsSidebarSidebar = {
           "description": "Learn how to use prices from external systems for products.",
           "children": []
         },
+        {
+          "loaded": true,
+          "isPathHref": true,
+          "type": "link",
+          "title": "Product Reviews",
+          "path": "/how-to-tutorials/tutorials/product-reviews",
+          "description": "Learn how to implement product reviews in your Medusa store.",
+          "children": []
+        },
         {
           "loaded": true,
           "isPathHref": true,

www/apps/resources/sidebars/fulfillment.mjs

@@ -93,7 +93,7 @@ export const fulfillmentSidebar = [
       {
         type: "category",
         title: "Admin User Guides",
-        autogenerate_tags: "userGuide+fulfillment",
+        autogenerate_tags: "fulfillment+userGuide",
         autogenerate_as_ref: true,
         sort_sidebar: "alphabetize",
         description:

www/apps/resources/sidebars/how-to-tutorials.mjs

@@ -78,6 +78,13 @@ While tutorials show you a specific use case, they also help you understand how
         description:
           "Learn how to use prices from external systems for products.",
       },
+      {
+        type: "link",
+        title: "Product Reviews",
+        path: "/how-to-tutorials/tutorials/product-reviews",
+        description:
+          "Learn how to implement product reviews in your Medusa store.",
+      },
       {
         type: "link",
         title: "Quote Management",

www/apps/resources/sidebars/product.mjs

@@ -39,7 +39,7 @@ export const productSidebar = [
       {
         type: "category",
         title: "Server Guides",
-        autogenerate_tags: "server+product",
+        autogenerate_tags: "product+server",
         autogenerate_as_ref: true,
         sort_sidebar: "alphabetize",
         description:

www/packages/build-scripts/src/utils/parse-tags.ts

@@ -46,11 +46,7 @@ const getIntersectionTags = (tags: string): Tag => {
     return tagsToIntersect
       .slice(1)
       .every((otherTag) =>
-        otherTag.some(
+        otherTag.some((otherTagItem) => otherTagItem.path === tagItem.path)
-          (otherTagItem) =>
-            otherTagItem.title === tagItem.title &&
-            otherTagItem.path === tagItem.path
-        )
       )
   })
 }

www/packages/tags/src/tags/product.ts

@@ -63,6 +63,10 @@ export const product = [
     "title": "Get Variant Price with Taxes",
     "path": "https://docs.medusajs.com/resources/commerce-modules/product/guides/price-with-taxes"
   },
+  {
+    "title": "Implement Product Reviews",
+    "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/product-reviews"
+  },
   {
     "title": "Build Wishlist Plugin",
     "path": "https://docs.medusajs.com/resources/plugins/guides/wishlist"

www/packages/tags/src/tags/server.ts

@@ -55,6 +55,10 @@ export const server = [
     "title": "Implement Quote Management",
     "path": "https://docs.medusajs.com/resources/examples/guides/quote-management"
   },
+  {
+    "title": "Product Reviews",
+    "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/product-reviews"
+  },
   {
     "title": "Build Wishlist Plugin",
     "path": "https://docs.medusajs.com/resources/plugins/guides/wishlist"

www/packages/tags/src/tags/tutorial.ts

@@ -23,6 +23,10 @@ export const tutorial = [
     "title": "Implement Quote Management",
     "path": "https://docs.medusajs.com/resources/examples/guides/quote-management"
   },
+  {
+    "title": "Product Reviews",
+    "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/product-reviews"
+  },
   {
     "title": "Build Wishlist Plugin",
     "path": "https://docs.medusajs.com/resources/plugins/guides/wishlist"