diff --git a/docs/content/add-plugins/sendgrid.mdx b/docs/content/add-plugins/sendgrid.mdx
index 9696b0f2ed..9f602f1601 100644
--- a/docs/content/add-plugins/sendgrid.mdx
+++ b/docs/content/add-plugins/sendgrid.mdx
@@ -24,7 +24,7 @@ By integrating SendGrid with Medusa, you’ll be sending email notifications to
Before going further with this guide make sure you have a Medusa server set up. You can follow our [Quickstart guide](../quickstart/quick-start.md).
-You also must have [Redis configured on your Medusa server](../tutorial/0-set-up-your-development-environment.md). Sending emails is done through Subscribers, which uses Redis as the event queue. If you don’t set up Redis, the plugin will not send emails.
+You also must have [Redis configured on your Medusa server](/tutorial/set-up-your-development-environment#redis). Sending emails is done through Subscribers, which uses Redis as the event queue. If you don’t set up Redis, the plugin will not send emails.
## Create a SendGrid Account
diff --git a/docs/content/add-plugins/stripe.md b/docs/content/add-plugins/stripe.md
index 4ca268ad95..76388d2b48 100644
--- a/docs/content/add-plugins/stripe.md
+++ b/docs/content/add-plugins/stripe.md
@@ -48,8 +48,8 @@ const plugins = [
{
resolve: `medusa-payment-stripe`,
options: {
- api_key: STRIPE_API_KEY,
- webhook_secret: STRIPE_WEBHOOK_SECRET,
+ api_key: process.env.STRIPE_API_KEY,
+ webhook_secret: process.env.STRIPE_WEBHOOK_SECRET,
},
},
];
@@ -57,7 +57,7 @@ const plugins = [
:::note
-You might find that this code is already available but commented out. You can proceed with removing the comments instead of adding the code again.
+You might find that this code is already available but commented out. You can proceed with removing the comments instead of adding the code again, but make sure to replace `STRIPE_API_KEY` and `STRIPE_WEBHOOK_SECRET` with `process.env.STRIPE_API_KEY` and `process.env.STRIPE_WEBHOOK_SECRET` respectively.
:::
@@ -131,7 +131,7 @@ All storefronts require that you obtain your Stripe’s Publishable Key. You can
Medusa has a Next.js storefront that you can easily use with your Medusa server. If you don’t have the storefront installed, you can follow [this quickstart guide](../starters/nextjs-medusa-starter).
-In your `.env` file, add the following variable with its value set to the Publishable Key:
+In your `.env.local` file (or the file you’re using for your environment variables), add the following variable with its value set to the Publishable Key:
```jsx
NEXT_PUBLIC_STRIPE_KEY=pk_...
diff --git a/docs/content/add-plugins/twilio-sms.md b/docs/content/add-plugins/twilio-sms.md
index af30de60f9..44b09d9436 100644
--- a/docs/content/add-plugins/twilio-sms.md
+++ b/docs/content/add-plugins/twilio-sms.md
@@ -66,7 +66,7 @@ In this example, you’ll create a subscriber that listens to the `order.placed`
:::tip
-For this example to work, you’ll need to install and configure Redis on your server. You can refer to the [development guide](../tutorial/0-set-up-your-development-environment.md#redis) to learn how to do that.
+For this example to work, you’ll need to install and configure Redis on your server. You can refer to the [development guide](/tutorial/set-up-your-development-environment#redis) to learn how to do that.
:::
diff --git a/docs/content/advanced/backend/migrations.md b/docs/content/advanced/backend/migrations.md
index e5949b7176..d838506eef 100644
--- a/docs/content/advanced/backend/migrations.md
+++ b/docs/content/advanced/backend/migrations.md
@@ -94,4 +94,4 @@ If you check your database now you should see that the change defined by the mig
## What’s Next 🚀
-- Learn more about [setting up your development server](../../tutorial/0-set-up-your-development-environment.md).
+- Learn more about [setting up your development server](/tutorial/set-up-your-development-environment).
diff --git a/docs/content/how-to/deploying-on-heroku.md b/docs/content/how-to/deploying-on-heroku.md
index abdf10face..204032730d 100644
--- a/docs/content/how-to/deploying-on-heroku.md
+++ b/docs/content/how-to/deploying-on-heroku.md
@@ -4,7 +4,7 @@ title: "Deploying on Heroku"
# Deploying on Heroku
-This is a guide for deploying a Medusa project on Heroku. Heroku is a PaaS that allows you to easily deploy your applications in the cloud.
+This is a guide for deploying a Medusa project on Heroku. Heroku is a PaaS (Platform as a Service) that allows you to easily deploy your applications in the cloud.