@@ -1,7 +1,11 @@
-'''
-Demonstrates using ax.plot's zdir keyword to plot 2D scatterplot data on
+"""
+=======================
+Plot 2D data on 3D plot
+=======================
+
+Demonstrates using ax.plot's zdir keyword to plot 2D data on
 selective axes of a 3D plot.
-'''
+"""
 
 from mpl_toolkits.mplot3d import Axes3D
 import numpy as np
 
@@ -1,3 +1,12 @@
+"""
+========================================
+Create 2D bar graphs in different planes
+========================================
+
+Demonstrates making a 3D plot which has 2D bar graphs projected onto
+planes y=0, y=1, etc.
+"""
+
 from mpl_toolkits.mplot3d import Axes3D
 import matplotlib.pyplot as plt
 import numpy as np
 
@@ -1,6 +1,10 @@
-'''
+"""
+==============================
+Create 3D histogram of 2D data
+==============================
+
 Demo of a histogram for 2 dimensional data as a bar graph in 3D.
-'''
+"""
 
 from mpl_toolkits.mplot3d import Axes3D
 import matplotlib.pyplot as plt
 
@@ -1,3 +1,11 @@
+"""
+============================
+Draw flat objects in 3D plot
+============================
+
+Demonstrate using pathpatch_2d_to_3d to 'draw' shapes and text on a 3D plot.
+"""
+
 import matplotlib.pyplot as plt
 from matplotlib.patches import Circle, PathPatch
 # register Axes3D class with matplotlib by importing Axes3D
 
@@ -1,3 +1,13 @@
+"""
+=============================================
+Generate polygons to fill under 3D line graph
+=============================================
+
+Demonstrate how to create polygons which fill the space under a line
+graph. In this example polygons are semi-transparent, creating a sort
+of 'jagged stained glass' effect.
+"""
+
 from mpl_toolkits.mplot3d import Axes3D
 from matplotlib.collections import PolyCollection
 import matplotlib.pyplot as plt