Index: src/main/webapp/richfaces/dropDownMenu/topMenu.xhtml
===================================================================
diff -u -N -r27403d6240cc36223df500b12aef4e223207a7f0 -r7079f17344ed7e4bcfe05753f574380f924eddae
--- src/main/webapp/richfaces/dropDownMenu/topMenu.xhtml	(.../topMenu.xhtml)	(revision 27403d6240cc36223df500b12aef4e223207a7f0)
+++ src/main/webapp/richfaces/dropDownMenu/topMenu.xhtml	(.../topMenu.xhtml)	(revision 7079f17344ed7e4bcfe05753f574380f924eddae)
@@ -5,29 +5,31 @@
 	xmlns:ui="http://java.sun.com/jsf/facelets">
 
 <ui:composition>
-	<p><b>rich:dropDownMenu</b> is a component that allows to organize
-	the hierarchical menu similar to one that almost every desktop
-	application has.</p>
+	<p>The <b>rich:dropDownMenu</b> component provides
+	hierarchical menu systems similar to those found in many desktop
+	applications.</p>
 	<ui:include src="#{demoNavigator.sampleIncludeURI}" />
 	<ui:include src="/templates/includes/source-view.xhtml">
 		<ui:param name="src" value="#{demoNavigator.sampleIncludeURI}" />
 		<ui:param name="sourceType" value="xhtml" />
 		<ui:param name="openLabel" value="View Source" />
 		<ui:param name="hideLabel" value="Hide Source" />
 	</ui:include>
-	<p>The drop-down menu has a label that always appears on the page
-	and invisible panel that appears with a particular client side event (<i>mouseover,
-	click etc</i>). The event is defined with an <b>showEvent</b> attribute.</p>
-	<p>Drop-down menu can contains a set of menuItem's, menuGroup's and
-	menuSeparator's. Group plays a role of label for secondary levels on
-	the menu. Separator is represented with horizontal lines between the
-	items or groups. An item is an active element that might produce Ajax
+	<p>The drop-down menu has a label that always appears on the page,
+	and an invisible panel that appears after a set client-side event. 
+	Use the <b>showEvent</b> attribute to define the event, such as <i>mouseover</i>
+	or <i>click</i>.</p>
+	<p>Drop-down menus can contain a set of <b>rich:menuItem</b> components, 
+	<b>rich:menuGroup</b> components, and
+	<b>rich:menuSeparator</b> components. Menu groups are used for secondary levels on
+	the menu. Menu separators are represented with horizontal lines between
+	items or groups. Menu items are active elements that might produce Ajax
 	or non-Ajax requests. The submission mode is defined with <b>mode</b>
-	attribute of the menu that has three possible options - "<i>server</i>",
-	"<i>ajax</i>" or "<i>client</i>". Mode "<i>client</i>" does not produce
-	any request, but allows you to provide your own functionality inside
-	the menu item with an inline content. Mode could be overriden for
-	concrete item</p>
+	attribute, which has three possible options: <i>server</i>,
+	<i>ajax</i>, or <i>client</i>. The <i>client</i> mode does not submit
+	a request, but allows you to provide your own functionality inside
+	the menu item with any in-line content. The <b>mode</b> attribute can be over-ridden in
+	child items.</p>
 </ui:composition>
 
-</html>
\ No newline at end of file
+</html>