diff --git a/docs/about/themes.html b/docs/about/themes.html
index a7d1f0ee..81b64f4f 100755
--- a/docs/about/themes.html
+++ b/docs/about/themes.html
@@ -17,12 +17,12 @@
 	
 		<h2>Theming overview</h2>
 		
-			<p>Every layout and widget in jQuery Mobile is designed around a new object-oriented CSS framework to make it possible to design complete sites and applications. The theming system is similar to the ThemeRoller system in jQuery UI but with a few important improvements:</p> 
+			<p>Every layout and widget in jQuery Mobile is designed around a new object-oriented CSS framework that makes it possible to apply a complete unified design to sites and applications. The theming system is similar to the ThemeRoller system in jQuery UI, but adds a few important improvements:</p> 
 
 			<ul> 
-				<li>By taking advantage of CSS3 properties to add rounded corners, box and text shadow and gradients instead of images, the theme file is very lightweight and reduces server requests.</li>
-				<li>Richer designs are now possible because themes now include multiple color "swatches": 4 bars with matching buttons for each, 3 content areas that can be freely mixed and matched to create visual texture</li> 
-				<li>Open-ended theming allows for additional theme swatches can be added to a theme to add almost unlimited more variety to designs</li> 
+				<li>It takes advantage of CSS3 properties to add rounded corners, box and text shadow and gradients instead of images, allowing the theme file to be very lightweight and reducing server requests.</li>
+				<li>Themes include multiple color "swatches" &mdash; each swatch consists of a header bar, content body, and button (with three states: active, ) that can be freely mixed and matched to create visual texture &mdash; making richer designs possible</li> 
+				<li>Open-ended theming allows for up to 26 unique swatches can be added to a theme to add almost unlimited more variety to designs</li> 
 				<li>All backgrounds now use CSS3 gradients to dramatically reduce file size and number of server requests</li> 
 				<li>A simplified icon set only includes the most commonly used icons in either black or white colors to reduce image weight</li> 
 			</ul>