SciTools · pelson · Feb 21, 2018 · Feb 21, 2018 · Feb 21, 2018 · Feb 21, 2018
diff --git a/lib/cartopy/examples/always_circular_stereo.py b/lib/cartopy/examples/always_circular_stereo.py
@@ -1,8 +1,13 @@
 """
-Keep Boundary Circular
-----------------------
+Custom Boundary Shape
+---------------------
 
-Setting the boundary of an image to be circular.
+This example demonstrates how a custom shape geometry may be used
+instead of the projection's default boundary.
+
+In this instance, we define the boundary as a circle in axes coordinates.
+This means that no matter the extent of the map itself, the boundary will
+always be a circle.
 
 """
 __tags__ = ['Lines and polygons']

diff --git a/lib/cartopy/examples/favicon.py b/lib/cartopy/examples/favicon.py
@@ -1,6 +1,8 @@
 """
-Favicon
--------
+Cartopy Favicon
+---------------
+
+The actual code to generate cartopy's favicon.
 
 """
 import cartopy.crs as ccrs

diff --git a/lib/cartopy/examples/features.py b/lib/cartopy/examples/features.py
@@ -2,6 +2,9 @@
 Features
 --------
 
+A demonstration of some of the built-in Natural Earth features found
+in cartopy.
+
 """
 __tags__ = ['Lines and polygons']
 

diff --git a/lib/cartopy/examples/global_map.py b/lib/cartopy/examples/global_map.py
@@ -2,6 +2,9 @@
 Global Map
 ----------
 
+An example of a simple map that compares Geodetic and Plate Carree lines
+between two locations.
+
 """
 __tags__ = ['Lines and polygons']
 

diff --git a/lib/cartopy/examples/hurricane_katrina.py b/lib/cartopy/examples/hurricane_katrina.py
@@ -2,6 +2,9 @@
 Hurricane Katrina
 -----------------
 
+This example uses the power of Shapely to illustrate states that are likely to
+have been significantly impacted by Hurricane Katrine.
+
 """
 __tags__ = ['Lines and polygons']
 

diff --git a/lib/cartopy/examples/logo.py b/lib/cartopy/examples/logo.py
@@ -1,6 +1,8 @@
 """
-Logo
-----
+Cartopy Logo
+------------
+
+The actual code to produce cartopy's logo.
 
 """
 import cartopy.crs as ccrs

diff --git a/lib/cartopy/examples/rotated_pole.py b/lib/cartopy/examples/rotated_pole.py
@@ -2,7 +2,7 @@
 Rotated pole boxes
 ------------------
 
-This example demonstrates the way a box is warped when it is defined
+A demonstration of the way a box is warped when it is defined
 in a rotated pole coordinate system.
 
 Try changing the ``box_top`` to ``44``, ``46`` and ``75`` to see the effect

diff --git a/lib/cartopy/examples/un_flag.py b/lib/cartopy/examples/un_flag.py
@@ -2,6 +2,9 @@
 UN Flag
 -------
 
+A demonstration of the power of Matplotlib combined with cartopy's Azimuthal
+Equidistant projection to reproduce the UN flag.
+
 """
 import cartopy.crs as ccrs
 import cartopy.feature as cfeature

diff --git a/lib/cartopy/examples/waves.py b/lib/cartopy/examples/waves.py
@@ -1,6 +1,8 @@
 """
-Waves
------
+Filled contours
+---------------
+
+An example of contourf on manufactured data.
 
 """
 __tags__ = ['Scalar data']