docs: triage issues + revamp troubleshooting guides (#14216)

* docs: triage issues + revamp troubleshooting guides

* small change

www/apps/book/app/learn/installation/page.mdx

@@ -28,7 +28,7 @@ While this is the recommended way to create a Medusa application, you can altern
 
 <Prerequisites items={[
   {
-    text: "Node.js v20+ (LTS versions)",
+    text: "Node.js v20+ (LTS versions only)",
     link: "https://nodejs.org/en/download"
   },
   {
@@ -36,7 +36,7 @@ While this is the recommended way to create a Medusa application, you can altern
     link: "https://git-scm.com/downloads"
   },
   {
-    text: "PostgreSQL",
+    text: "PostgreSQL installed and running",
     link: "https://www.postgresql.org/download/"
   }
 ]} />

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

@@ -96,7 +96,7 @@ export const generatedEditDates = {
   "app/learn/build/page.mdx": "2025-10-27T09:30:26.957Z",
   "app/learn/deployment/general/page.mdx": "2025-10-21T07:39:08.998Z",
   "app/learn/fundamentals/workflows/multiple-step-usage/page.mdx": "2025-08-01T14:59:59.501Z",
-  "app/learn/installation/page.mdx": "2025-11-26T12:14:47.372Z",
+  "app/learn/installation/page.mdx": "2025-12-04T14:30:00.510Z",
   "app/learn/fundamentals/data-models/check-constraints/page.mdx": "2025-07-25T13:50:21.065Z",
   "app/learn/fundamentals/module-links/link/page.mdx": "2025-11-28T13:42:03.037Z",
   "app/learn/fundamentals/workflows/store-executions/page.mdx": "2025-04-17T08:29:10.166Z",

www/apps/book/public/llms-full.txt

@@ -25386,9 +25386,9 @@ While this is the recommended way to create a Medusa application, you can altern
 
 ### Prerequisites
 
-- [Node.js v20+ (LTS versions)](https://nodejs.org/en/download)
+- [Node.js v20+ (LTS versions only)](https://nodejs.org/en/download)
 - [Git CLI tool](https://git-scm.com/downloads)
-- [PostgreSQL](https://www.postgresql.org/download/)
+- [PostgreSQL installed and running](https://www.postgresql.org/download/)
 
 To create a Medusa application, use the `create-medusa-app` command:
 
@@ -46123,7 +46123,7 @@ const step1 = createStep(
   "step-1",
   async ({}, { container }) => {
     const eventModuleService = container.resolve(
-      Modules.EVENT
+      Modules.EVENT_BUS
     )
 
     await eventModuleService.emit({
@@ -46162,7 +46162,7 @@ Medusa provides the following Event Modules. You can use one of them, or [Create
 
 The Redis Event Module uses Redis to implement Medusa's pub/sub events system.
 
-It's powered by BullMQ and `io-redis`. BullMQ is responsible for the message queue and worker, and `io-redis` is the underlying Redis client that BullMQ connects to for events storage.
+It's powered by [BullMQ](https://bullmq.io/) and `io-redis`. BullMQ is responsible for the message queue and worker, and `io-redis` is the underlying Redis client that BullMQ connects to for events storage.
 
 In production, it's recommended to use this module.
 
@@ -46190,6 +46190,19 @@ module.exports = defineConfig({
       resolve: "@medusajs/medusa/event-bus-redis",
       options: { 
         redisUrl: process.env.EVENTS_REDIS_URL,
+        // suggested additional options for production use
+        jobOptions: {
+          removeOnComplete: {
+            // keep jobs for 1 hour or up to 1000 jobs
+            age: 3600,
+            count: 1000,
+          },
+          removeOnFail: {
+            // keep jobs for 1 hour or up to 1000 jobs
+            age: 3600,
+            count: 1000,
+          }
+        }
       },
     },
   ],