diff --git a/Mapnik2.md b/Mapnik2.md
index 449d022..b9e0c06 100644
--- a/Mapnik2.md
+++ b/Mapnik2.md
@@ -51,12 +51,17 @@ The Mapnik2 API has advanced (requiring breakages) and the XML syntax has change
 Therefore Mapnik2 is the [first release](MapnikReleases) with significant backward incompatibility. See [[Mapnik2_Changes]]
 
 # Upgrade Guide
+1. Recommended: rebuild shapefile indexes
 
-1. rebuild all shapefile indexes
+Say you have a directory of shapefiles in a folder named 'shapes'. Then you can regenerate all the indexes at once like:
 
-2. upgrade stylesheets with a python script:
+```
+shapeindex shapes/*.shp
+```
 
-We have written a python converter to seamlessly upgrade your pre-Mapnik2 stylesheets to be fully compatible with Mapnik2.
+2. Required: upgrade stylesheets
+
+We have written a python converter to automatically upgrade your pre-Mapnik2 stylesheets to be fully compatible with Mapnik2.
 
 After installing Mapnik2 you will have a new command available called 'upgrade_map_xml.py':