diff --git a/README.md b/README.md
index 0a4bb519..39fec652 100644
--- a/README.md
+++ b/README.md
@@ -13,5 +13,9 @@
 
 You can now see the site at [localhost:4000](http://localhost:4000)
 
+## Deploy
+
+It's **important** that you build the site with `JEKYLL_ENV=production bundle exec jekyll build` before deploying the contents of the `_site` directory. We're doing some debugging stuff when then project is build in the development env.
+
 ## Structure
 The contents of the index page is defined in the frontmatter of the file `index.md`
\ No newline at end of file