docs: add a note about installing preview version (#8648)

- Add a note about ensuring a package's version is set to `preview` in `package.json`
- Add a troubleshooting guide for deployments with a section about preview versions
- Added a troubleshooting section to the railway deployment guide about preview versions

Closes #8646
Closes DOCS-913

www/apps/resources/app/architectural-modules/cache/in-memory/page.mdx

@@ -28,6 +28,12 @@ To install the In-Memory Cache Module, run the following command in the director
 npm install @medusajs/cache-inmemory@preview
 ```
 
+<Note>
+
+Make sure that the version added in `package.json` is `preview` to avoid errors with installation and updates in the future.
+
+</Note>
+
 Next, add the module into the `modules` property of the exported object in `medusa-config.js`:
 
 ```js title="medusa-config.js"

www/apps/resources/app/architectural-modules/cache/redis/page.mdx

@@ -24,6 +24,12 @@ To install Redis Cache Module, run the following command in the directory of you
 npm install @medusajs/cache-redis@preview
 ```
 
+<Note>
+
+Make sure that the version added in `package.json` is `preview` to avoid errors with installation and updates in the future.
+
+</Note>
+
 Next, add the module into the `modules` property of the exported object in `medusa-config.js`:
 
 export const highlights = [

www/apps/resources/app/architectural-modules/event/local/page.mdx

@@ -26,6 +26,12 @@ To install Local Event Bus Module, run the following command in the directory of
 npm install @medusajs/event-bus-local@preview
 ```
 
+<Note>
+
+Make sure that the version added in `package.json` is `preview` to avoid errors with installation and updates in the future.
+
+</Note>
+
 Next, add the module into the `modules` property of the exported object in `medusa-config.js`:
 
 ```js title="medusa-config.js"

www/apps/resources/app/architectural-modules/event/redis/page.mdx

@@ -28,6 +28,12 @@ To install Redis Event Bus Module, run the following command in the directory of
 npm install @medusajs/event-bus-redis@preview
 ```
 
+<Note>
+
+Make sure that the version added in `package.json` is `preview` to avoid errors with installation and updates in the future.
+
+</Note>
+
 Next, add the module into the `modules` property of the exported object in `medusa-config.js`:
 
 export const highlights = [

www/apps/resources/app/architectural-modules/file/local/page.mdx

@@ -30,6 +30,12 @@ To install the Local File Module Provider, run the following command in the dire
 npm install @medusajs/file-local-next@preview
 ```
 
+<Note>
+
+Make sure that the version added in `package.json` is `preview` to avoid errors with installation and updates in the future.
+
+</Note>
+
 Next, add the module into the `providers` array of the File Module:
 
 <Note>

www/apps/resources/app/architectural-modules/file/s3/page.mdx

@@ -96,6 +96,12 @@ To install the S3 File Module Provider, run the following command in the directo
 npm install @medusajs/file-s3@preview
 ```
 
+<Note>
+
+Make sure that the version added in `package.json` is `preview` to avoid errors with installation and updates in the future.
+
+</Note>
+
 Next, add the module into the `providers` array of the File Module:
 
 <Note>

www/apps/resources/app/architectural-modules/notification/local/page.mdx

@@ -24,6 +24,12 @@ To install the Local Notification Module Provider, run the following command in
 npm install @medusajs/notification-local@preview
 ```
 
+<Note>
+
+Make sure that the version added in `package.json` is `preview` to avoid errors with installation and updates in the future.
+
+</Note>
+
 Next, add the module into the `providers` array of the Notification Module:
 
 <Note>

www/apps/resources/app/architectural-modules/notification/sendgrid/page.mdx

@@ -26,6 +26,12 @@ To install the SendGrid Notification Module Provider, run the following command
 npm install @medusajs/notification-sendgrid@preview
 ```
 
+<Note>
+
+Make sure that the version added in `package.json` is `preview` to avoid errors with installation and updates in the future.
+
+</Note>
+
 Next, add the module into the `providers` array of the Notification Module:
 
 <Note>

www/apps/resources/app/architectural-modules/workflow-engine/in-memory/page.mdx

@@ -28,6 +28,12 @@ To install the In-Memory Workflow Engine Module, run the following command in th
 npm install @medusajs/workflow-engine-inmemory@preview
 ```
 
+<Note>
+
+Make sure that the version added in `package.json` is `preview` to avoid errors with installation and updates in the future.
+
+</Note>
+
 Next, add the module into the `modules` property of the exported object in `medusa-config.js`:
 
 ```js title="medusa-config.js"

www/apps/resources/app/architectural-modules/workflow-engine/redis/page.mdx

@@ -24,6 +24,12 @@ To install Redis Workflow Engine Module, run the following command in the direct
 npm install @medusajs/workflow-engine-redis@preview
 ```
 
+<Note>
+
+Make sure that the version added in `package.json` is `preview` to avoid errors with installation and updates in the future.
+
+</Note>
+
 Next, add the module into the `modules` property of the exported object in `medusa-config.js`:
 
 export const highlights = [