diff --git a/docs/src/behavior.md b/docs/src/behavior.md
index 81b71c0e..e69b7f76 100644
--- a/docs/src/behavior.md
+++ b/docs/src/behavior.md
@@ -3,11 +3,11 @@ layout: two-columns
 title: Dropdown Behavior
 ---
 
-Our [JS library `docsearch.js`] is a wrapper of the [autocomplete.js][1]
-library. This library will listen to keystrokes in the search input, query
-Algolia and display the results in a dropdown. Everything is already configured
-for you to work with DocSearch, but it also exposes configuration options you
-can use to go even further.
+Our JS library `docsearch.js` is a wrapper of the [autocomplete.js][1] library.
+This library will listen to keystrokes in the search input, query Algolia and
+displays the results in a dropdown. Everything is already configured for you to
+work with DocSearch, but it also exposes configuration options you can use to go
+even further.
 
 ## `appId`
 
diff --git a/docs/src/how-do-we-build-an-index.md b/docs/src/how-do-we-build-an-index.md
index f9c9efa3..ff4cf022 100644
--- a/docs/src/how-do-we-build-an-index.md
+++ b/docs/src/how-do-we-build-an-index.md
@@ -13,11 +13,11 @@ _Note: We would rather avoid useless js rendering. Every used information should
 be avaible without any client-side rendering. You can use `curl` in order to
 have a better idea of how does it look._
 
-### We extract the payload thank to your set of `selectors`
+### We extract the payload thanks to your set of `selectors`
 
 <img src="./assets/how_do_we_build_docsearch_index_2.png" alt="2nd step" class="mt-2"/>
 
-We will only focus on the information highlted thank to your selectors.
+We will focus on the information highlted via your selectors.
 
 ### We iterate though the HTML flow and build the payload
 
@@ -28,9 +28,9 @@ This payload will be the only considered data from your page.
 ### We iterate though the payload and start pushing record
 
 <img src="./assets/how_do_we_build_docsearch_index_4.png" alt="4th step" class="mt-2"/>
- 
-We index the temporary record at every time we agregate an element int it (if
-`min_indexed_level` is set to `0` ).
+
+We index the temporary record at every time we add an element int it (if
+`min_indexed_level` is set to `0` )
 
 ### We pile them up based on the current temporary record