docs: add upgrade guide for 1.3.8 (#2170)

* add upgrade guide for 1.3.8

* added to sidebar

* added announcement bar

docs/content/advanced/backend/upgrade-guides/1-3-8.md

@@ -0,0 +1,33 @@
+# v1.3.8
+
+Updating your medusa server to version `1.3.8` may cause issues when using NPM. Please refer to this guide for more details on how to resolve it.
+
+## Update Using Yarn
+
+We highly recommend using [yarn](https://yarnpkg.com/) when working with Medusa. Updating with yarn should resolve any issues you might run into during the update.
+
+## Resolving Update Issues with NPM
+
+### Update All Medusa Dependencies
+
+If you face any errors during your update to version `1.3.8`, make sure to update all Medusa dependencies you’re using on your server. This includes `medusa-interfaces`, `@medusajs/medusa-cli`, or any of Medusa’s official plugins.
+
+You can update to the latest version of these using the `@latest` version tag. For example:
+
+```bash
+npm install medusa-interfaces@latest
+```
+
+### Use Legacy Peer Dependencies Option
+
+:::caution
+
+This solution can be used as a workaround and should be used with caution to avoid any issues while using Medusa.
+
+:::
+
+If all fails, you can use the `--legacy-peer-deps` option while updating Medusa:
+
+```bash
+npm install @medusajs/medusa@latest --legacy-peer-deps
+```

www/docs/docusaurus.config.js

@@ -32,6 +32,14 @@ module.exports = {
     ]
   ],
   themeConfig: {
+    announcementBar: {
+      id: 'release-1-3-8',
+      content:
+        'New Release! Version 1.3.8 of Medusa is out now! Read all about it <a href="https://github.com/medusajs/medusa/releases/tag/v1.3.8">here</a>.',
+      backgroundColor: '#7C53FF',
+      textColor: '#fff',
+      isCloseable: false,
+    },
     colorMode: {
       defaultMode: 'light',
       disableSwitch: false,

www/docs/sidebars.js

@@ -169,6 +169,11 @@ module.exports = {
               id: "advanced/backend/upgrade-guides/1-3-6",
               label: "v1.3.6"
             },
+            {
+              type: "doc",
+              id: "advanced/backend/upgrade-guides/1-3-8",
+              label: "v1.3.8"
+            },
           ]
         },
       ]