diff --git a/docs/examples/0_io/README.md b/docs/examples/0_io/README.md
index 3c28edce..64546360 100644
--- a/docs/examples/0_io/README.md
+++ b/docs/examples/0_io/README.md
@@ -1,3 +1,3 @@
-### Import / Export
+## Import / Export
 
 These tutorials will illustrate how to load and save your data:
diff --git a/docs/examples/1_plotting/README.md b/docs/examples/1_plotting/README.md
index 12d96689..cfdfe9c9 100644
--- a/docs/examples/1_plotting/README.md
+++ b/docs/examples/1_plotting/README.md
@@ -1,3 +1,3 @@
-### Plotting
+## Plotting
 
 These tutorials will show you how to visualize your neurons:
diff --git a/docs/examples/1_plotting/tutorial_plotting_06_cortex.py b/docs/examples/1_plotting/tutorial_plotting_06_cortex.py
index 3a5adbaf..93ceed72 100644
--- a/docs/examples/1_plotting/tutorial_plotting_06_cortex.py
+++ b/docs/examples/1_plotting/tutorial_plotting_06_cortex.py
@@ -26,8 +26,8 @@
 # %%
 # ## Part I: Loading and Aligning Neurons
 #
-# First we need to load the neurons. Here, we will take them straight from their FTP server but you can of course download them first
-# and load then from disk!
+# First we need to load the neurons. Here, we will take them straight from their FTP server
+# but you can of course download them first and then load from disk!
 
 import navis
 
@@ -190,7 +190,8 @@ def plot_neurons(to_plot, color="purple", axon_color="magenta", offset=500):
 fig, ax = plot_neurons(nl)
 
 # %% [markdown]
-# Next, let's calculate the distribution of cable lengths:
+# That looks close enough. The last bit is to add the little KDE plots for the depth-distribution of
+# cable length:
 #
 # We're going to be cheap here and simply generate a histogram over the node positions.
 # To make this representative, we should make sure that the number of nodes per unit of cable
@@ -216,12 +217,12 @@ def plot_neurons(to_plot, color="purple", axon_color="magenta", offset=500):
 nodes.head()
 
 # %%
-# Now we can plot the distribution of cable lengths for the neurons of the type we're interested in:
+# Now we can plot the distribution of cable lengths for our neurons:
 
 import seaborn as sns
 from mpl_toolkits.axes_grid1 import make_axes_locatable
 
-# Plot the neurons using the function we defined earlier
+# Plot the neurons again, re-using the function we defined above
 fig, ax = plot_neurons(nl)
 
 # Add a new axis to the right of the main plot
diff --git a/docs/examples/2_morpho/README.md b/docs/examples/2_morpho/README.md
index a52743a5..c3e271cf 100644
--- a/docs/examples/2_morpho/README.md
+++ b/docs/examples/2_morpho/README.md
@@ -1,3 +1,3 @@
-### Morphology
+## Morphology
 
 These tutorials will show you how to analyse and manipulate your neurons' morphology:
diff --git a/docs/examples/3_interfaces/README.md b/docs/examples/3_interfaces/README.md
index 309beac0..b4cf75d8 100644
--- a/docs/examples/3_interfaces/README.md
+++ b/docs/examples/3_interfaces/README.md
@@ -1,3 +1,3 @@
-### Interfaces
+## Interfaces
 
 These tutorials cover interfaces between {{ navis }} and external tools:
diff --git a/docs/examples/4_remote/README.md b/docs/examples/4_remote/README.md
index 25b55798..106e05fb 100644
--- a/docs/examples/4_remote/README.md
+++ b/docs/examples/4_remote/README.md
@@ -1,3 +1,3 @@
-### Remote Data Sources
+## Remote Data Sources
 
 These tutorials will show you how to load data from remote data sources:
diff --git a/docs/examples/5_nblast/README.md b/docs/examples/5_nblast/README.md
index be6d26cc..fdc7790f 100644
--- a/docs/examples/5_nblast/README.md
+++ b/docs/examples/5_nblast/README.md
@@ -1,3 +1,3 @@
-### NBLAST
+## NBLAST
 
 These tutorials will teach you how to run NBLASTs to compare neuron morphology.
diff --git a/docs/examples/6_misc/README.md b/docs/examples/6_misc/README.md
index 27e6f6aa..31c46e0c 100644
--- a/docs/examples/6_misc/README.md
+++ b/docs/examples/6_misc/README.md
@@ -1 +1 @@
-### Misc
+## Misc