diff --git a/.gitignore b/.gitignore
index 2907d28..c53c34e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -8,7 +8,7 @@ benchmark_history.svg
 __pycache__/
 venv/
 .venv/
-docs/reference/
+docs_src/reference/
 *.egg-info
 .coverage
 dist/
diff --git a/docs/gen_ref_pages.py b/docs_src/gen_ref_pages.py
similarity index 100%
rename from docs/gen_ref_pages.py
rename to docs_src/gen_ref_pages.py
diff --git a/docs/index.md b/docs_src/index.md
similarity index 100%
rename from docs/index.md
rename to docs_src/index.md
diff --git a/mkdocs.yaml b/mkdocs.yaml
index 86730fd..2b58c02 100644
--- a/mkdocs.yaml
+++ b/mkdocs.yaml
@@ -1,5 +1,8 @@
 site_name: Order Book Matching Engine
 
+docs_dir: docs_src
+site_dir: docs
+
 theme:
   name: material
   palette:
@@ -27,7 +30,7 @@ plugins:
       include_dir: .
   - gen-files:
       scripts:
-        - docs/gen_ref_pages.py
+        - docs_src/gen_ref_pages.py
   - literate-nav:
       nav_file: SUMMARY.md
   - mkdocstrings: