diff --git a/examples/mplot3d/2dcollections3d_demo.py b/examples/mplot3d/2dcollections3d_demo.py
index 54bf1f39839b..436219ae8e93 100644
--- a/examples/mplot3d/2dcollections3d_demo.py
+++ b/examples/mplot3d/2dcollections3d_demo.py
@@ -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
diff --git a/examples/mplot3d/bars3d_demo.py b/examples/mplot3d/bars3d_demo.py
index 478a16abd89e..2cb2a5078b35 100644
--- a/examples/mplot3d/bars3d_demo.py
+++ b/examples/mplot3d/bars3d_demo.py
@@ -1,7 +1,11 @@
-'''
+"""
+========================================
+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
diff --git a/examples/mplot3d/hist3d_demo.py b/examples/mplot3d/hist3d_demo.py
index 839226a73716..603645b651e0 100644
--- a/examples/mplot3d/hist3d_demo.py
+++ b/examples/mplot3d/hist3d_demo.py
@@ -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
diff --git a/examples/mplot3d/pathpatch3d_demo.py b/examples/mplot3d/pathpatch3d_demo.py
index 33d097494898..55d33dc94823 100644
--- a/examples/mplot3d/pathpatch3d_demo.py
+++ b/examples/mplot3d/pathpatch3d_demo.py
@@ -1,7 +1,12 @@
-'''
+"""
+============================
+Draw flat objects in 3D plot
+============================
+
 Demonstrate using pathpatch_2d_to_3d to 'draw' shapes and text on a 3D plot.
-'''
+"""
 
+import numpy as np
 import matplotlib.pyplot as plt
 from matplotlib.patches import Circle, PathPatch
 # register Axes3D class with matplotlib by importing Axes3D
diff --git a/examples/mplot3d/polys3d_demo.py b/examples/mplot3d/polys3d_demo.py
index 7e1687c0357b..0d04d213a1ff 100644
--- a/examples/mplot3d/polys3d_demo.py
+++ b/examples/mplot3d/polys3d_demo.py
@@ -1,7 +1,12 @@
-'''
-Demonstrate how to create semi-transparent polygons which fill the space
-under a line graph, creating a sort of 'jagged stained glass' effect.
-'''
+"""
+=============================================
+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