Various fixes for 6.1 release (#495)

* Various fixes for 6.1 release * XML fix
StyleGuides · Jul 5, 2023 · 05c8e06 · 05c8e06
1 parent 3993109
commit 05c8e06
Show file tree

Hide file tree

Showing 8 changed files with 14 additions and 14 deletions.
diff --git a/en-US/B.xml b/en-US/B.xml
@@ -382,7 +382,7 @@
 					See <ulink url="http://en.wikipedia.org/wiki/Btrfs" /> for more information on this file system.
 				</para>
 				 <para>
-					See <ulink url="http://en.wikipedia.org/wiki/List_of_file_systems" /> for a list of file system names and how to present them.
+					See <ulink url="http://en.wikipedia.org/wiki/List_of_file_systems" /> for a list of file-system names and how to present them.
 				</para>
 
 			</listitem>

diff --git a/en-US/Design.xml b/en-US/Design.xml
@@ -709,7 +709,7 @@ $ vi myFile.txt
 
 				</formalpara>
 				 <para>
-					For example, you are the system administrator at Global Banking and you are asked to set up permissions to the accounting directory for the following users: John Doe, Sunni Koning, Huong Sabo, and Jerlene Paluch. John is a department manager and needs read access to the accounting directory. Sunni is the lead accountant and needs both read and write access.
+					For example, you are the system administrator at Global Banking and you are asked to set up permissions to the accounting directory for the following users: Sunni Koning, Huong Sabo, and Jerlene Paluch. Sunni is a department manager and needs read access to the accounting directory. Huong is the lead accountant and needs both read and write access.
 				</para>
 				 <formalpara id="choosing-realistic-names">
 					<title>Choosing a Realistic Name</title>
@@ -1160,10 +1160,10 @@ $ vi myFile.txt
 		<title>Using Admonitions</title>
 		 <para>
 			To call attention to a statement, use an admonition.
-      Red&nbsp;Hat technical documentation currently uses <command>Note</command>, <command>Important</command>, and <command>Warning</command> admonitions.
+      Red&nbsp;Hat technical documentation currently uses <systemitem>Note</systemitem>, <systemitem>Important</systemitem>, and <systemitem>Warning</systemitem> admonitions.
 		</para>
 		 <para>
-			Admonitions automatically include a suitable title according to the type of admonition.
+			Depending on the tools and workflow, admonitions might automatically include a suitable title according to the type of admonition.
       Do not use a phrase or anything else for the title.
       Keep the following considerations in mind if using admonitions:
 			<itemizedlist>
@@ -1181,20 +1181,20 @@ $ vi myFile.txt
 				</listitem>
 				 <listitem>
 					<para>
-						Use a <command>Note</command> admonition to bring extra information to the user's attention.
+						Use a <systemitem>Note</systemitem> admonition to bring extra information to the user's attention.
 					</para>
 
 				</listitem>
 				 <listitem>
 					<para>
-						Use an <command>Important</command> admonition to show the user a piece of information that should not be overlooked.
+						Use an <systemitem>Important</systemitem> admonition to show the user a piece of information that should not be overlooked.
             This information might not change anything that the user is doing, but it should show the user that this piece of information could be vital.
 					</para>
 
 				</listitem>
 				 <listitem>
 					<para>
-						Use a <command>Warning</command> admonition to alert the reader to potential changes, such as files being removed, and not to perform the operation unless fully aware of the consequences.
+						Use a <systemitem>Warning</systemitem> admonition to alert the reader to potential changes, such as files being removed, and not to perform the operation unless fully aware of the consequences.
 					</para>
 
 				</listitem>

diff --git a/en-US/E.xml b/en-US/E.xml
@@ -40,7 +40,7 @@
 			<term>Emacs</term>
 			 <listitem>
 				<para>
-					If referring to the program, use "Emacs". For example, "Source-Navigator supports Emacs or vi commands". If referring to the shell prompt command, use "emacs". For example, "At the prompt, type <command>emacs</command>." The complete and correct name is "GNU Emacs".
+					If referring to the program, use "Emacs". For example, "Source-Navigator supports Emacs or vi commands". If referring to the shell prompt command, use "emacs". For example, "At the prompt, type <systemitem>emacs</systemitem>." The complete and correct name is "GNU Emacs".
 				</para>
 
 			</listitem>
@@ -64,7 +64,7 @@
 					When referring to the keyboard key, use <keycap>Enter</keycap>. If referring to the keyboard key on Solaris, use <keycap>Return</keycap>.
 				</para>
 				 <para>
-					When referring to typing a command, use "type" instead, such as "To open Source-Navigator from the command line, type <command>snavigator</command>."
+					When referring to typing a command, use "type" instead, such as "To open Source-Navigator from the command line, type <systemitem>snavigator</systemitem>."
 				</para>
 				 <para>
 					When typing information into a single-field dialog box, "enter" means "type and press <keycap>Enter</keycap>". An example is "enter the license number". For multi-field dialog boxes, see "type".

diff --git a/en-US/Grammar.xml b/en-US/Grammar.xml
@@ -759,7 +759,7 @@
 				</thead>
 				 <tbody>
 					<row>
-						<entry> The <command>fsck /dev/vdb1</command> command performs a file system check on the XFS file system residing on the <filename>/dev/vdb1</filename> partition. </entry>
+						<entry> The <command>fsck /dev/vdb1</command> command performs a file-system check on the XFS file system residing on the <filename>/dev/vdb1</filename> partition. </entry>
 						 <entry> The <command>fsck /dev/vdb1</command> command checks the XFS file system on the <filename>/dev/vdb1</filename> partition. </entry>
 
 					</row>

diff --git a/en-US/Language.xml b/en-US/Language.xml
@@ -1644,7 +1644,7 @@
 		Use numerals for numbers 10 and greater, and for numbers less than 10 if they appear in the same paragraph as numbers of 10 or greater (for example, "You answered 8 out of 14 questions correctly"). Use numerals for negative numbers, fractions, percentages, decimals, measurements, and references to book sections (for example, Chapter 3, Table 5, Page 11). Also use numerals when referring to registers (such as R1), code (such as x = 6), and release versions (such as Red&nbsp;Hat Enterprise&nbsp;Linux&nbsp;8, Linux kernel&nbsp;4.18).
 		</para>
 		 <para>
-		Do not use commas in numbers with four digits (use 1000 rather than 1,000). Use commas, to separate goups of three digits, in numbers with five or more digits (such as 10,000; 123,456,789; 1,000,000,000).
+		Do not use commas in numbers with four digits (use 1000 rather than 1,000). Use commas, to separate groups of three digits, in numbers with five or more digits (such as 10,000; 123,456,789; 1,000,000,000).
 		</para>
     	 <para>
 		See <citetitle>The Chicago Manual of Style, 17th Edition</citetitle> for detailed information on numbering formats.

diff --git a/en-US/N.xml b/en-US/N.xml
@@ -117,7 +117,7 @@
 			 <listitem>
 				<para>
 					Generally, use "number sign" to refer to the # character.
-          Or, use "hash" to refer to a hashtag in social media, or to refer to Secure Hash Algorithm (see <xref linkend="sha" />), or when writing exclusively for a European audience.
+          Otherwise, use "hash" to refer to a hashtag in social media, or to refer to Secure Hash Algorithm (see <xref linkend="sha" />), or when writing exclusively for a European audience.
           You can instead use "pound sign" when writing exclusively for a North American audience, if "number sign" is not appropriate for the context.  
 				</para>
 

diff --git a/en-US/New.xml b/en-US/New.xml
@@ -41,7 +41,7 @@
                                         <para>Use "following" with a noun.</para>
 				</listitem>
 				<listitem>
-                                        <para>Avoid hyphenating with an "-ly" prefix: added an example.</para>		
+                                        <para>Avoid hyphenating with an "-ly" suffix: added an example.</para>		
 				</listitem>
 				<listitem>
                                         <para>If-Then statements.</para>

diff --git a/en-US/O.xml b/en-US/O.xml
@@ -250,7 +250,7 @@
 			 <listitem>
 				<para>
 					A phrase that was coined by the Red&nbsp;Hat community and adopted by opensource.com in 2009.
-          It is a reference to an "open source method", as in "Let's develop this project the open source way."
+          It is a reference to an "open source method", as in "The team developed this project the open source way."
 				</para>
 				 <para>
 					Do not use to suggest that something is being done only in the "spirit" of open source without having an open source policy as defined by <ulink url="http://opensource.org/osd">Open Source Initiative</ulink>, to avoid diluting the legal meaning of the term "open source".