diff --git a/examples/lines_bars_and_markers/scatter_with_legend.py b/examples/lines_bars_and_markers/scatter_with_legend.py
index c6b35a27956..fba5cf22167 100644
--- a/examples/lines_bars_and_markers/scatter_with_legend.py
+++ b/examples/lines_bars_and_markers/scatter_with_legend.py
@@ -1,3 +1,11 @@
+'''
+Demo of a scatter plot (scatter) with a legend.
+
+Also demonstrates how transparency of the markers
+can be adjusted by giving ``alpha`` a value between
+0 and 1.
+'''
+
 import matplotlib.pyplot as plt
 from numpy.random import rand