docs: format gallery

Author: schlegelp

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:

docs/examples/1_plotting/README.md

@@ -1,3 +1,3 @@
-### Plotting
+## Plotting
 
 These tutorials will show you how to visualize your neurons:

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

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:

docs/examples/3_interfaces/README.md

@@ -1,3 +1,3 @@
-### Interfaces
+## Interfaces
 
 These tutorials cover interfaces between {{ navis }} and external tools:

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:

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.

docs/examples/6_misc/README.md

@@ -1 +1 @@
-### Misc
+## Misc