diff --git a/docs/.gitignore b/docs/.gitignore
index 122c8a2be8..2f10cb1dc7 100644
--- a/docs/.gitignore
+++ b/docs/.gitignore
@@ -6,8 +6,9 @@ env/
 *.pyd
 *.pyc
 
-# Sphinx files
-_build
+# Documentation build files
+_build/
+site/
 
 # Temp files
 releases.json
diff --git a/docs/__init__.py b/docs/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/docs/__init__.py b/docs/docs/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
index 6cf7b8a6d5..d6beff9fcd 100644
--- a/docs/mkdocs.yml
+++ b/docs/mkdocs.yml
@@ -193,9 +193,9 @@ plugins:
   - git-revision-date-localized
   - mkdocs-simple-hooks:
       hooks:
-        on_config: "docs.hooks:on_config"
+        on_config: "docs.docs.hooks:on_config"
   - macros:
-      include_dir: _includes
+      include_dir: docs/_includes
 
 # Extensions
 markdown_extensions: