diff --git a/docs/explanations.md b/docs/explanations.md
new file mode 100644
index 00000000..3bfd6b06
--- /dev/null
+++ b/docs/explanations.md
@@ -0,0 +1,15 @@
+---
+orphan: true
+---
+
+# Explanations
+
+Explanations of how it works and why it works that way.
+
+```{toctree}
+:maxdepth: 1
+
+explanations/technical-terms
+explanations/why-stack-frames
+explanations/why-squash-can-change-path
+```
diff --git a/docs/explanations.rst b/docs/explanations.rst
deleted file mode 100644
index c9b1be15..00000000
--- a/docs/explanations.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-:orphan:
-
-Explanations
-============
-
-Explanation of how the library works and why it works that way.
-
-.. toctree::
-    :caption: Explanations
-
-    explanations/technical-terms
-    explanations/why-stack-frames
-    explanations/why-squash-can-change-path
diff --git a/docs/how-to.md b/docs/how-to.md
new file mode 100644
index 00000000..8a4b3c9e
--- /dev/null
+++ b/docs/how-to.md
@@ -0,0 +1,14 @@
+---
+orphan: true
+---
+
+# How-to Guides
+
+Practical step-by-step guides for the more experienced user.
+
+```{toctree}
+:maxdepth: 1
+
+how-to/iterate-a-spec
+how-to/serialize-a-spec
+```
diff --git a/docs/how-to.rst b/docs/how-to.rst
deleted file mode 100644
index 9efa4f2d..00000000
--- a/docs/how-to.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-:orphan:
-
-How-to Guides
-=============
-
-Practical step-by-step guides for the more experienced user.
-
-.. toctree::
-    :caption: How-to Guides
-
-    how-to/iterate-a-spec
-    how-to/serialize-a-spec
diff --git a/docs/index.md b/docs/index.md
index 10955d0d..4229d146 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,3 +1,7 @@
+---
+html_theme.sidebar_secondary.remove: true
+---
+
 ```{include} ../README.md
 :end-before: <!-- README only content
 ```
@@ -16,41 +20,40 @@ top bar.
 ::::{grid} 2
 :gutter: 4
 
-:::{grid-item-card} {material-regular}`directions_walk;2em` Tutorials
-:link: tutorials
-:link-type: doc
+:::{grid-item-card} {material-regular}`directions_walk;2em` 
+```{toctree}
+:maxdepth: 2
 
+tutorials
+```
 Tutorials for installation and typical usage. New users start here.
 :::
 
-:::{grid-item-card} {material-regular}`directions;2em` How-to Guides
-:link: how-to
-:link-type: doc
+:::{grid-item-card} {material-regular}`directions;2em`
+```{toctree}
+:maxdepth: 2
 
+how-to
+```
 Practical step-by-step guides for the more experienced user.
 :::
 
-:::{grid-item-card} {material-regular}`info;2em` Explanations
-:link: explanations
-:link-type: doc
+:::{grid-item-card} {material-regular}`info;2em`
+```{toctree}
+:maxdepth: 2
 
+explanations
+```
 Explanations of how it works and why it works that way.
 :::
 
-:::{grid-item-card} {material-regular}`menu_book;2em` Reference
-:link: reference
-:link-type: doc
+:::{grid-item-card} {material-regular}`menu_book;2em`
+```{toctree}
+:maxdepth: 2
 
+reference
+```
 Technical reference material including APIs and release notes.
 :::
 
 ::::
-
-```{toctree}
-:hidden:
-
-tutorials
-how-to
-explanations
-reference
-```
\ No newline at end of file
diff --git a/docs/reference.md b/docs/reference.md
new file mode 100644
index 00000000..888a455c
--- /dev/null
+++ b/docs/reference.md
@@ -0,0 +1,19 @@
+---
+orphan: true
+---
+
+# Reference
+
+Technical reference material including APIs and release notes.
+
+```{toctree}
+:maxdepth: 1
+
+reference/api
+reference/rest_api
+reference/contributing
+Index <genindex.html#http://>
+```
+
+% Index link above is a hack to make genindex.html a relative link
+% https://stackoverflow.com/a/31820846
diff --git a/docs/reference.rst b/docs/reference.rst
deleted file mode 100644
index 211d6ff4..00000000
--- a/docs/reference.rst
+++ /dev/null
@@ -1,19 +0,0 @@
-:orphan:
-
-Reference
-=========
-
-Practical step-by-step guides for the more experienced user.
-
-.. toctree::
-    :caption: Reference
-
-    reference/api
-    reference/rest_api
-    reference/contributing
-    Releases <https://github.com/dls-controls/scanspec/releases>
-    Index <genindex.html#http://>
-
-..
-    Index link above is a hack to make genindex.html a relative link
-    https://stackoverflow.com/a/31820846
diff --git a/docs/tutorials.md b/docs/tutorials.md
new file mode 100644
index 00000000..0f5a750c
--- /dev/null
+++ b/docs/tutorials.md
@@ -0,0 +1,11 @@
+# Tutorials
+
+Tutorials for installation and typical usage. New users start here.
+
+```{toctree}
+:maxdepth: 1
+
+tutorials/installation
+tutorials/creating-a-spec
+tutorials/rest-service
+```
diff --git a/docs/tutorials.rst b/docs/tutorials.rst
deleted file mode 100644
index e30e8d8d..00000000
--- a/docs/tutorials.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-:orphan:
-
-Tutorials
-=========
-
-Tutorials for installation, library and commandline usage. New users start here.
-
-.. toctree::
-    :caption: Tutorials
-
-    tutorials/installation
-    tutorials/creating-a-spec
-    tutorials/rest-service