diff --git a/website/docs/deployment.md b/website/docs/deployment.md
index 3dac6d4232c2..5c38f39c3d51 100644
--- a/website/docs/deployment.md
+++ b/website/docs/deployment.md
@@ -9,7 +9,7 @@ To build the static files of your website for production, run:
 npm run build
 ```
 
-Once it finishes, you should see the production build under the `build/` directory.
+Once it finishes, the static files will be generated within the `build/` directory.
 
 You can deploy your site to static site hosting services such as [ZEIT Now](https://zeit.co/now), [GitHub Pages](https://pages.github.com/), [Netlify](https://www.netlify.com/), [Render](https://render.com/static-sites), and [Surge](https://surge.sh/help/getting-started-with-surge). Docusaurus sites are statically rendered so they work without JavaScript too!
 
diff --git a/website/docs/markdown-features.mdx b/website/docs/markdown-features.mdx
index 6af41a403e63..fd48093e8482 100644
--- a/website/docs/markdown-features.mdx
+++ b/website/docs/markdown-features.mdx
@@ -124,7 +124,7 @@ image: https://i.imgur.com/mErPwqL.png
 
 ## Referencing other documents
 
-If you want to reference another document file, you should use the name of the document you want to reference. Docusaurus will convert the file path to be the final website path (and remove the `.md`).
+If you want to reference another document file, you could use the name of the document you want to reference. Docusaurus will convert the file path to be the final website path (and remove the `.md`).
 
 For example, if you are in `doc2.md` and you want to reference `doc1.md` and `folder/doc3.md`: