diff --git a/docs/search.md b/docs/search.md
index cdb85713ce1050f61145c05f8a2292b410375aa5..52835781325045a4b6a6d96e9755c641e01e1fb6 100644
--- a/docs/search.md
+++ b/docs/search.md
@@ -23,7 +23,7 @@ $ bundle exec just-the-docs rake search:init
 
 This command creates the `search-data.json` file that Jekyll uses to create
 your search index. Alternatively, you can create the file manually in the
-root of your Jekyll site with this content:
+`assets/js/` of your Jekyll site with this content:
 
 ```{% raw %}
 ---
@@ -39,4 +39,4 @@ root of your Jekyll site with this content:
 }{% endraw %}
 ```
 
-You can modify this by modifying the forloop in `search-data.json` and the javascript in `just-the-docs.js` on line 30.
+_Note: If you don't run this rake command or create this file manually, search will not work (or it will use the search index data from this docs site, not your site's content)._
diff --git a/index.md b/index.md
index 4f4c121de909ab4e436c9c68c8efa271661316aa..66c833903fdea3fdf8a9be21b7361d15a40f8600 100644
--- a/index.md
+++ b/index.md
@@ -2,6 +2,7 @@
 layout: default
 title: Home
 nav_order: 1
+permalink: /
 ---