diff --git a/docs/index.rst b/docs/index.rst
index 9775d66..0afa9c0 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -96,6 +96,8 @@ Table Of Contents
 
     introduction.rst
     installation.rst
+    key_concepts.rst
+    key_concepts_algebra.rst
     introductory_examples.rst
     tutorials.rst
     objects.rst
diff --git a/docs/introduction.rst b/docs/introduction.rst
index 3ea32f0..486bb87 100644
--- a/docs/introduction.rst
+++ b/docs/introduction.rst
@@ -270,17 +270,6 @@ customized to match the look and feel of your company's documentation. They also
 provide multiple output formats, support for multiple languages and can be
 integrated with code management tools.
 
-****************************************
-Key Concepts (builder mode)
-****************************************
-
-.. include:: key_concepts.rst
-
-****************************************
-Key Concepts (algebra mode)
-****************************************
-
-.. include:: key_concepts_algebra.rst
 
 ************************
 Advantages Over CadQuery
diff --git a/docs/key_concepts.rst b/docs/key_concepts.rst
index b58949a..3afc0e1 100644
--- a/docs/key_concepts.rst
+++ b/docs/key_concepts.rst
@@ -1,3 +1,7 @@
+###########################
+Key Concepts (builder mode)
+###########################
+
 There are two primary APIs provided by build123d: builder and algebra. The builder
 api may be easier for new users as it provides some assistance and shortcuts; however,
 if you know what a Quaternion is you might prefer the algebra API which allows
diff --git a/docs/key_concepts_algebra.rst b/docs/key_concepts_algebra.rst
index 6eee8a2..94b26bf 100644
--- a/docs/key_concepts_algebra.rst
+++ b/docs/key_concepts_algebra.rst
@@ -1,3 +1,6 @@
+###########################
+Key Concepts (algebra mode)
+###########################
 
 Build123d's algebra mode works on objects of the classes ``Shape``, ``Part``, ``Sketch`` and ``Curve`` and is based on two concepts: