diff --git a/examples/axes_grid1/demo_colorbar_with_inset_locator.py b/examples/axes_grid1/demo_colorbar_with_inset_locator.py
index 79d2001c1ea6..0133da3f22b4 100644
--- a/examples/axes_grid1/demo_colorbar_with_inset_locator.py
+++ b/examples/axes_grid1/demo_colorbar_with_inset_locator.py
@@ -1,7 +1,14 @@
 """
-================================
-Demo Colorbar With Inset Locator
-================================
+==============================================================
+Controlling the position and size of colorbars with Inset Axes
+==============================================================
+
+This example shows how to control the position, height, and width of
+colorbars using `~mpl_toolkits.axes_grid1.inset_axes`.
+
+Controlling the placement of the inset axes is done similarly as that of the
+legend: either by providing a location option ("upper right", "best", ...), or
+by providing a locator with respect to the parent bbox.
 
 """
 import matplotlib.pyplot as plt
@@ -11,16 +18,16 @@
 fig, (ax1, ax2) = plt.subplots(1, 2, figsize=[6, 3])
 
 axins1 = inset_axes(ax1,
-                    width="50%",  # width = 10% of parent_bbox width
-                    height="5%",  # height : 50%
+                    width="50%",  # width = 50% of parent_bbox width
+                    height="5%",  # height : 5%
                     loc='upper right')
 
 im1 = ax1.imshow([[1, 2], [2, 3]])
-plt.colorbar(im1, cax=axins1, orientation="horizontal", ticks=[1, 2, 3])
+fig.colorbar(im1, cax=axins1, orientation="horizontal", ticks=[1, 2, 3])
 axins1.xaxis.set_ticks_position("bottom")
 
 axins = inset_axes(ax2,
-                   width="5%",  # width = 10% of parent_bbox width
+                   width="5%",  # width = 5% of parent_bbox width
                    height="50%",  # height : 50%
                    loc='lower left',
                    bbox_to_anchor=(1.05, 0., 1, 1),
@@ -33,6 +40,6 @@
 # the bbox_to_anchor coordinate.
 
 im = ax2.imshow([[1, 2], [2, 3]])
-plt.colorbar(im, cax=axins, ticks=[1, 2, 3])
+fig.colorbar(im, cax=axins, ticks=[1, 2, 3])
 
 plt.show()