matplotlib · dstansby · Mar 19, 2017 · Mar 16, 2017
diff --git a/examples/mplot3d/contour3d_demo.py b/examples/mplot3d/contour3d_demo.py
@@ -1,9 +1,11 @@
-'''
-Demonstrates plotting contour (level) curves in 3D.
+"""
+==================================================
+Demonstrates plotting contour (level) curves in 3D
+==================================================
 
 This is like a contour plot in 2D except that the f(x,y)=c curve is plotted
 on the plane z=c.
-'''
+"""
 
 from mpl_toolkits.mplot3d import axes3d
 import matplotlib.pyplot as plt

diff --git a/examples/mplot3d/contour3d_demo2.py b/examples/mplot3d/contour3d_demo2.py
@@ -1,5 +1,7 @@
 '''
-Demonstrates plotting contour (level) curves in 3D using the extend3d option.
+============================================================================
+Demonstrates plotting contour (level) curves in 3D using the extend3d option
+============================================================================
 
 This modification of the contour3d_demo example uses extend3d=True to
 extend the curves vertically into 'ribbons'.

diff --git a/examples/mplot3d/contour3d_demo3.py b/examples/mplot3d/contour3d_demo3.py
@@ -1,4 +1,8 @@
 '''
+========================================
+Projecting contour profiles onto a graph
+========================================
+
 Demonstrates displaying a 3D surface while also projecting contour 'profiles'
 onto the 'walls' of the graph.
 

diff --git a/examples/mplot3d/contourf3d_demo.py b/examples/mplot3d/contourf3d_demo.py
@@ -1,4 +1,8 @@
 '''
+===============
+Filled contours
+===============
+
 contourf differs from contour in that it creates filled contours, ie.
 a discrete number of colours are used to shade the domain.
 

diff --git a/examples/mplot3d/contourf3d_demo2.py b/examples/mplot3d/contourf3d_demo2.py
@@ -1,4 +1,8 @@
 '''
+======================================
+Projecting filled contour onto a graph
+======================================
+
 Demonstrates displaying a 3D surface while also projecting filled contour
 'profiles' onto the 'walls' of the graph.
 

diff --git a/examples/mplot3d/custom_shaded_3d_surface.py b/examples/mplot3d/custom_shaded_3d_surface.py
@@ -1,4 +1,8 @@
 """
+=======================================
+Custom hillshading in a 3D surface plot
+=======================================
+
 Demonstrates using custom hillshading in a 3D surface plot.
 """
 

diff --git a/examples/mplot3d/lines3d_demo.py b/examples/mplot3d/lines3d_demo.py
@@ -1,4 +1,8 @@
 '''
+===================
+3D parametric curve
+===================
+
 Demonstrating plotting a parametric curve in 3D.
 '''
 

diff --git a/examples/mplot3d/lorenz_attractor.py b/examples/mplot3d/lorenz_attractor.py
@@ -1,4 +1,8 @@
 '''
+====================
+The Lorenz Attractor
+====================
+
 Plot of the Lorenz Attractor based on Edward Lorenz's 1963 "Deterministic
 Nonperiodic Flow" publication.
 http://journals.ametsoc.org/doi/abs/10.1175/1520-0469%281963%29020%3C0130%3ADNF%3E2.0.CO%3B2

diff --git a/examples/mplot3d/mixed_subplots_demo.py b/examples/mplot3d/mixed_subplots_demo.py
@@ -1,4 +1,8 @@
 """
+==================
+2D and 3D subplots
+==================
+
 Demonstrate the mixing of 2d and 3d subplots.
 """
 

diff --git a/examples/mplot3d/offset_demo.py b/examples/mplot3d/offset_demo.py
@@ -1,4 +1,8 @@
 '''
+===================
+Offset text display
+===================
+
 This example demonstrates mplot3d's offset text display.
 As one rotates the 3D figure, the offsets should remain oriented the
 same way as the axis label, and should also be located "away"