diff --git a/docs/content/add-plugins/algolia.md b/docs/content/add-plugins/algolia.md
index a5d13f5c62..c6de15bff7 100644
--- a/docs/content/add-plugins/algolia.md
+++ b/docs/content/add-plugins/algolia.md
@@ -57,7 +57,7 @@ And that's all! You've now enabled Algolia for your Medusa store engine. The plu
 
 **Usage**
 
-This article will not go too much into depth about how the search functionality works under the hood when querying the API. We refer to the [previous article on MeiliSearch](https://www.medusajs.com/post/meilisearch-and-medusa) if this is of your interest. In there, you will find a quick showcase using Postman as well as a thorough walkthrough of how you can display the results in your storefront using ReactJS (GatsbyJS).
+This article will not go too much into depth about how the search functionality works under the hood when querying the API. We refer to the [previous article on MeiliSearch](https://medusajs.com/blog/meilisearch-medusa) if this is of your interest. In there, you will find a quick showcase using Postman as well as a thorough walkthrough of how you can display the results in your storefront using ReactJS (GatsbyJS).
 
 Instead, to illustrate the power of our Search API and search engine plugins, we'll switch out a MeiliSearch plugin with our new Algolia plugin in a store with existing products. Upon restarting the server with the new configuration, your products will automatically be fed into Algolia and the search functionality in your frontend will remain unchanged.
 
diff --git a/docs/content/how-to/deploying-on-heroku.md b/docs/content/how-to/deploying-on-heroku.md
index 7695b94217..abdf10face 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 at 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 that allows you to easily deploy your applications in the cloud.
 
 <div>
   <video width="100%" height="100%" playsinline autoplay muted controls>
@@ -57,7 +57,7 @@ Follow the instructions on your terminal
 
 ### 3. Create an app on Heroku
 
-In your **Medusa project directory** run the following commands to create an app on Heroku and add it as a remote origin.
+In your **Medusa project directory**, run the following commands to create an app on Heroku and add it as a remote origin.
 
 ```bash
 heroku create medusa-test-app
@@ -70,13 +70,13 @@ Medusa requires a Postgres database and a Redis instance to work. These are adde
 
 :::tip
 
-In this below example, we initialize the resources on free plans. This is not a valid configuration for a production environment.
+In this example below, we initialize the resources on free plans. This is not a valid configuration for a production environment.
 
 :::
 
 #### Postgresql
 
-Add a Postgres addon to your Heroku app
+Add a Postgres add-on to your Heroku app
 
 ```bash
 heroku addons:create heroku-postgresql:hobby-dev
@@ -90,7 +90,7 @@ Add a Redis instance to your Heroku app
 
 :::note
 
-The addon `redistogo:nano` is free, but Heroku requires you to add a payment method to proceed.
+The add-on `redistogo:nano` is free, but Heroku requires you to add a payment method to proceed.
 
 :::
 
@@ -102,7 +102,7 @@ You can find more informations, plans and pricing about Redis To Go [here](https
 
 ### 5. Configure environment variables on Heroku
 
-Medusa requires a set of environment variables. From you project repository run the following commands:.
+Medusa requires a set of environment variables. From you project repository, run the following commands:.
 
 ```bash
 heroku config:set NODE_ENV=production