diff --git a/docs/source/algorithm.md b/docs/source/documentation/algorithm.md
similarity index 91%
rename from docs/source/algorithm.md
rename to docs/source/documentation/algorithm.md
index 3845eab26bc00c7d7c8949eaf84d34596c07503f..b575d861dc6c6b2cbd360154c96e0f00f2c8e8c5 100644
--- a/docs/source/algorithm.md
+++ b/docs/source/documentation/algorithm.md
@@ -1,3 +1,15 @@
+---
+jupytext:
+  text_representation:
+    extension: .md
+    format_name: myst
+    format_version: 0.13
+    jupytext_version: 1.14.4
+kernelspec:
+  display_name: Python 3 (ipykernel)
+  language: python
+  name: python3
+---
 # Algorithm overview
 
 ## Self-consistency loop
diff --git a/docs/source/mf_notes.md b/docs/source/documentation/mf_notes.md
similarity index 94%
rename from docs/source/mf_notes.md
rename to docs/source/documentation/mf_notes.md
index 33d49dd7a17619bf65e5a61ecb36e2eb9d1337fd..8c8d063f14dd710d1804fe91cb838afd35e89f1c 100644
--- a/docs/source/mf_notes.md
+++ b/docs/source/documentation/mf_notes.md
@@ -1,3 +1,15 @@
+---
+jupytext:
+  text_representation:
+    extension: .md
+    format_name: myst
+    format_version: 0.13
+    jupytext_version: 1.14.4
+kernelspec:
+  display_name: Python 3 (ipykernel)
+  language: python
+  name: python3
+---
 # Theory overview
 
 ## Interacting problems
diff --git a/docs/source/index.md b/docs/source/index.md
index 5bc8c5593f3f720812dc7723dc692b85c172db73..4ca49e09d5f2a9719b2c4d43204cfda695d42680 100644
--- a/docs/source/index.md
+++ b/docs/source/index.md
@@ -18,12 +18,8 @@ kernelspec:
 :maxdepth: 1
 :caption: Tutorials
 
-
-mf_notes.md
-algorithm.md
-hubbard_1d.md
-graphene_example.md
-
+tutorial/hubbard_1d.md
+tutorial/graphene_example.md
 ```
 
 ```{toctree}
@@ -31,8 +27,8 @@ graphene_example.md
 :maxdepth: 1
 :caption: Documentation
 
-mf_notes.md
-algorithm.md
+documentation/mf_notes.md
+documentation/algorithm.md
 documentation/pymf.md
 ```
 
diff --git a/docs/source/graphene_example.md b/docs/source/tutorial/graphene_example.md
similarity index 100%
rename from docs/source/graphene_example.md
rename to docs/source/tutorial/graphene_example.md
diff --git a/docs/source/hubbard_1d.md b/docs/source/tutorial/hubbard_1d.md
similarity index 100%
rename from docs/source/hubbard_1d.md
rename to docs/source/tutorial/hubbard_1d.md