Various fixes (#512)

Author: julian-cable

en-US/Design.xml

@@ -16,7 +16,7 @@
 				<title>Capitalization</title>
 					<para>
 					The standard for all Red&nbsp;Hat technical documentation is title case for all headings and titles.
-            Table headings, procedure headings, and formal paragraph titles fall under this heading; standard title case capitalization rules apply.
+            Table headings and procedure headings fall under this heading; standard title case capitalization rules apply.
 					</para>
 		</formalpara>
 			<para>
@@ -1277,13 +1277,12 @@ Book Title by First name Surname; Publisher.
 </programlisting>
 
 		 <para>
-			For example, <citetitle>Maximum RPM</citetitle> by
-			<author>
+			For example, <citetitle>Maximum RPM</citetitle> by Edward Bailey; Red&nbsp;Hat Press.
+			<!-- <author>
 				<firstname>Edward</firstname>
 				 <surname>Bailey</surname>
 
-			</author>
-			; Red&nbsp;Hat Press.
+			</author> -->
 		</para>
 		 <formalpara id="other-websites">
 			<title>Referencing Other Internet Sites</title>

en-US/Grammar.xml

@@ -277,7 +277,7 @@
 				</listitem>
 				 <listitem>
 					<para>
-						If the restatement contains the word <emphasis>he</emphasis>, <emphasis>she</emphasis>, <emphasis>they</emphasis>, I<emphasis>I</emphasis>, or <emphasis>we</emphasis>, then use <emphasis>who</emphasis> or <emphasis>whoever</emphasis>. "Do you think he would mind?" "Who do you think would mind?" "She's walking in the door." "Who's walking in the door?"
+						If the restatement contains the word <emphasis>he</emphasis>, <emphasis>she</emphasis>, <emphasis>they</emphasis>, <emphasis>I</emphasis>, or <emphasis>we</emphasis>, then use <emphasis>who</emphasis> or <emphasis>whoever</emphasis>. "Do you think he would mind?" "Who do you think would mind?" "She's walking in the door." "Who's walking in the door?"
 					</para>
 
 				</listitem>
@@ -300,7 +300,7 @@
 			<title>Sentence Length</title>
 			 <para>
 				Try not to pack too much information into one sentence.
-        In technical documentation, try not to exceed 30 words in a sentence.
+        In technical documentation, try not to exceed 40 words in a sentence.
         Keep it short.
         The following sentence is a bad writing example:
 			</para>

en-US/Language.xml

@@ -704,7 +704,7 @@
 				<term>shoot yourself in the foot</term>
 				 <listitem>
 					<para>
-						To "shoot yourself in the foot" indicates that you did something to harm your own cause, or acting against your own best interests. Remove the sentence; it should be self-evident from the surrounding information. (Found this statement alongside the "double-edged sword" comment with an added note about "preserving all your toes".)
+						To "shoot yourself in the foot" indicates that you did something to harm your own cause, or acting against your own best interests. Remove the sentence; it should be self-evident from the surrounding information.
 					</para>
 
 				</listitem>

en-US/P.xml

@@ -15,7 +15,7 @@
 				 <warning>
 					<title>Marketing, Brand, Customer Portal Usage</title>
 					 <para>
-						For all-caps text, such as banners, use "&lt;VARIANT&gt;-ASERVICE" for the spelled-out version. The same abbreviation is used across all groups.
+						For all-caps text, such as banners, use "&lt;VARIANT&gt;-AS-A-SERVICE" for the spelled-out version. The same abbreviation is used across all groups.
 					</para>
 
 				</warning>

en-US/Translation.xml

@@ -272,27 +272,18 @@
 								<para>
 									To obtain the file name of the default kernel with the <command>grubby</command> command: 
 								</para>
-								<para>
-									...  
-								</para>
 
 							</listitem>
 							 <listitem>
 								<para>
 									Finding the index number of the default kernel:
 								</para>
-								<para>
-									...  
-								</para>
 
 							</listitem>
 							 <listitem>
 								<para>
 									Use the <command>grubby</command> command to persistently change the default kernel:
 								</para>
-								<para>
-									...  
-								</para>
 
 							</listitem>							
 
@@ -304,27 +295,18 @@
 								<para>
 									Obtain the file name of the default kernel with the <command>grubby</command> command:
 								</para>
-								<para>
-									...  
-								</para>
 
 							</listitem>
 							 <listitem>
 								<para>
 									Find the index number of the default kernel:
 								</para>
-								<para>
-									...  
-								</para>
 
 							</listitem>
 							 <listitem>
 								<para>
 									Use the <command>grubby</command> command to persistently change the default kernel:
 								</para>
-								<para>
-									...  
-								</para>
 
 							</listitem>