Implement suggestions from Ashley D'Andrea (#589)

julian-cable · web-flow · commit 9b0862265f9e · 2024-07-04T10:27:36.000+01:00
* Implement suggestions from Ashley D'Andrea

* Apply feedback from Rachel

* Apply feedback from Ashley
diff --git a/en-US/Book_Design.xml b/en-US/Book_Design.xml
@@ -64,7 +64,7 @@
 	 <section id="prefaces">
 		<title>Prefaces</title>
 		 <para>
-			The brands that form part of Publican contain a preface as part of the common content. Whether your publication is for external Red&nbsp;Hat customers, JBoss customers, internal customers, or whomever, the brand you choose should provide a suitable preface. Try to use the standard preface to help maintain consistency, reduce overhead and maintenance, and also to reduce translation costs. If you feel that the preface fails to meet your needs, consider whether or not you are using the correct brand, or if the brand itself requires an update.
+			The brands that form part of Publican (<ulink url="https://fedorahosted.org/publican/" />) contain a preface as part of the common content. Whether your publication is for external Red&nbsp;Hat customers, JBoss customers, internal customers, or whomever, the brand you choose should provide a suitable preface. Try to use the standard preface to help maintain consistency, reduce overhead and maintenance, and also to reduce translation costs. If you feel that the preface fails to meet your needs, consider whether or not you are using the correct brand, or if the brand itself requires an update.
 		</para>
 
 	</section>
diff --git a/en-US/C.xml b/en-US/C.xml
@@ -95,7 +95,7 @@
 					Do not use "characters" to mean "bytes". In English, bytes and characters can be used interchangeably; in other languages, a single character might consist of multiple bytes.
 				</para>
 				 <para>
-					In computer software, any symbol that requires one byte of storage. This includes all the ASCII and extended ASCII characters, including the space character. In character-based software, everything that appears on the screen, including graphics symbols, is considered to be a character. In graphics-based applications, the term character is generally reserved for letters, numbers, and punctuation.
+					In computer software, a character is a symbol, such as a letter or number, that represents information. This includes all the ASCII and extended ASCII characters, including the space character. In character-based software, everything that appears on the screen, including graphics symbols, is considered to be a character. In graphics-based applications, the term character is generally reserved for letters, numbers, and punctuation.
 				</para>
 
 			</listitem>
@@ -443,8 +443,8 @@
 			<term>cookie</term>
 			 <listitem>
 				<para>
-					<emphasis>n.</emphasis> A message given to a web browser by a web server.
-          The browser stores the message in a text file named <filename>cookie.txt</filename>.
+					<emphasis>n.</emphasis> Data that is given to a web browser by a web server.
+          The browser stores the message in a text file that might be named <filename>cookie.txt</filename>.
           The message is then sent back to the server each time the browser requests a page from the server.
 				</para>
 
diff --git a/en-US/Design.xml b/en-US/Design.xml
@@ -637,7 +637,7 @@ STEP 14: COMMIT <emphasis>...output omitted...</emphasis> localhost/nexus:latest
           </listitem>
           <listitem>
             <para>
-              As much as possible, leave the systemwide default as <varname>become: false</varname> or <varname>become: no</varname> and if a single task needs privileges, set <varname>become: true</varname> or <varname>become: yes</varname> on that task.
+              As much as possible, leave the system-wide default as <varname>become: false</varname> or <varname>become: no</varname> and if a single task needs privileges, set <varname>become: true</varname> or <varname>become: yes</varname> on that task.
             </para>
           </listitem>
           <listitem>
@@ -1043,7 +1043,7 @@ STEP 14: COMMIT <emphasis>...output omitted...</emphasis> localhost/nexus:latest
 			<title>First Mentions</title>
 		 <para>
 			Spell out most acronyms and initialisms before using them in text, such as "The Embedded DevKit (EDK) ...".
-           	Unless required for the audience or the topic, do not spell out well-known abbreviations, such as HTML.
+           	Unless required for the audience or the topic, do not spell out well-known initialisms, such as HTML.
 		</para>
 		</formalpara>
 
diff --git a/en-US/G.xml b/en-US/G.xml
@@ -30,13 +30,14 @@
 			<term>GB</term>
 			 <listitem>
 				<para>
-					Abbreviation of gigabyte. Depending on the type of content you are writing, refer either to <citetitle>The AP Style Guide</citetitle> or the <citetitle>IBM Style Guide.</citetitle>
+					Abbreviation of gigabyte. 
+					<!-- Depending on the type of content you are writing, refer either to <citetitle>The AP Style Guide</citetitle> or the <citetitle>IBM Style Guide.</citetitle> -->
 				</para>
-				 <para>
+<!-- 				 <para>
 					AP style: Do not use a space between the value and the abbreviation. For example, "a 2GB file".
-				</para>
+				</para> -->
 				 <para>
-					IBM style: Use a non-breaking space between the value and the abbreviation. For example, "a 2&nbsp;GB file".
+					Use a non-breaking space between the value and the abbreviation. For example, "a 2&nbsp;GB file".
 				</para>
 
 			</listitem>
diff --git a/en-US/Grammar.xml b/en-US/Grammar.xml
@@ -972,7 +972,7 @@ Split contractions and abbreviations into separate paragraphs. -->
 		 <formalpara id="hyphenate-complex-adjectives">
 			<title>Hyphenate Complex Adjectives</title>
 			 <para>
-				Hyphenate complex adjectives (compound modifiers). This is when two adjectives work together to modify an object. The hyphen is used when the first adjective modifies the second adjective. For example, cloud-based solutions, right-side paralysis, systemwide menu.
+				Hyphenate complex adjectives (compound modifiers). This is when two adjectives work together to modify an object. The hyphen is used when the first adjective modifies the second adjective. For example, cloud-based solutions, right-side paralysis, system-wide menu.
 			</para>
 
 		</formalpara>
diff --git a/en-US/Language.xml b/en-US/Language.xml
@@ -527,7 +527,7 @@
 				<term>low-hanging fruit</term>
 				 <listitem>
 					<para>
-						Metaphor. Do not use.
+						Metaphor. Do not use. Instead, describe the outcome or opportunity in more precise terms, such as "readily achievable goals" or "low-risk, high-yield opportunities". 
 					</para>
 
 				</listitem>
@@ -1168,7 +1168,7 @@
 								</row>
 								<row>
 									<entry> Kubernetes is an open source system that makes it easy to manage containerized applications across multiple hosts. </entry>
-									 <entry> Kubernetes is an open source system to manage containerized applications across multiple hosts. </entry>
+									 <entry> Kubernetes is an open source system that manages containerized applications across multiple hosts. </entry>
 
 								</row>
 
@@ -1238,8 +1238,8 @@
 							</thead>
 							 <tbody>
 								<row>
-									<entry> Tab through the dialog box. Set the tab. Move the tab on the ruler. How to show or hide tabs. Select the tab. </entry>
-									 <entry> Use the tab key to move through the dialog box. Set the tab stop. Move the tab mark on the ruler. How to show or hide tab characters. Select the <guimenuitem>View</guimenuitem> tab in the <guimenuitem>Options</guimenuitem> dialog box. </entry>
+									<entry> Tab through the dialog box. Set the tab. Move the tab on the ruler. How to show or hide tab characters. Select the tab. </entry>
+									 <entry> Use the tab key to move through the dialog box. Set the tab stop. Move the tab mark on the ruler. To show or hide tab characters in Vim, use the <command>/\t</command> and <command>noh</command> commands. Select the <guimenuitem>View</guimenuitem> tab in the <guimenuitem>Options</guimenuitem> dialog box. </entry>
 
 								</row>
 								 <row>
diff --git a/en-US/S.xml b/en-US/S.xml
@@ -652,7 +652,10 @@ a programming and technical sense, it also means "Run the <command>source</comma
 			<term>SSL</term>
 			 <listitem>
 				<para>
-					Initialism for Secure Sockets Layer, a protocol developed by Netscape for transmitting private documents over the internet. SSL uses a public key to encrypt data that is transferred over the SSL connection. Most web browsers support SSL, and many websites use the protocol to obtain confidential user information, such as credit card numbers. By convention, URLs that require an SSL connection start with <emphasis>https:</emphasis> instead of <emphasis>http:</emphasis>.
+					Initialism for Secure Sockets Layer, a protocol developed by Netscape for transmitting private documents over the internet. SSL uses a public key to encrypt data that is transferred over the SSL connection. Most web browsers support SSL, and many websites use the protocol to obtain confidential user information, such as credit card numbers. By convention, URLs that require an SSL connection start with <emphasis>https:</emphasis> instead of <emphasis>http:</emphasis>. SSL later evolved into Transport Layer Security (TLS).
+				</para>
+				 <para>
+					Refer also to <xref linkend="tls" />.
 				</para>
 
 			</listitem>
diff --git a/en-US/T.xml b/en-US/T.xml
@@ -187,6 +187,16 @@
 
 			</listitem>
 
+		</varlistentry>
+		 <varlistentry id="tls">
+			<term>TLS</term>
+			 <listitem>
+				<para>
+					Initialism for Transport Layer Security, a security protocol that provides privacy and data integrity for internet communications. By convention, URLs that require a TLS connection start with <emphasis>https:</emphasis> instead of <emphasis>http:</emphasis>. 
+				</para>
+
+			</listitem>
+
 		</varlistentry>
 		 <varlistentry id="token-ring">
 			<term>token-ring</term>
diff --git a/en-US/Translation.xml b/en-US/Translation.xml
@@ -42,7 +42,7 @@
                 <para>
                     These appear as numbered lists.
                     Use this list type for multiple entries if you need to refer to one of the entries from elsewhere in your document, or where order is important.
-                    For example, if you need to list the order of operations that are required to prepare for an installation, or list a sequence of events that occurs.
+                    For example, use an ordered list for a sequence of steps to complete a task, or for a sequence of events.
                     Titles are optional.
                 </para>
             </listitem>
@@ -154,7 +154,7 @@
 						</para>
 						 </entry>
 						 <entry> <para>
-							Before you start the installation, follow these steps to ensure a smooth installation:
+							Before you start the installation, follow these prerequisite steps:
 						</para>
 						 <itemizedlist>
 							<listitem>
@@ -625,13 +625,13 @@
 
 					</row>
 					 <row>
-						<entry> Troubleshooting Glance. </entry>
-						 <entry> Troubleshooting the Glance image service. </entry>
+						<entry> Troubleshoot Glance. </entry>
+						 <entry> Troubleshoot the Glance image service. </entry>
 
 					</row>
 					 <row>
-						<entry> Installing the <package>maven-changelog-plugin</package>. </entry>
-						 <entry> Installing the <package>maven-changelog-plugin</package> package. </entry>
+						<entry> Install the <package>maven-changelog-plugin</package>. </entry>
+						 <entry> Install the <package>maven-changelog-plugin</package> package. </entry>
 
 					</row>
 
diff --git a/en-US/U.xml b/en-US/U.xml
@@ -182,10 +182,10 @@
 
 		</varlistentry>
 		 <varlistentry id="url">
-			<term>URL</term>
+			<term>URL, URI</term>
 			 <listitem>
 				<para>
-					<emphasis>n.</emphasis> Include the appropriate protocol, such as http, ftp, or https, at the beginning of URLs. That is, use http://www.redhat.com and not www.redhat.com.
+					<emphasis>n.</emphasis> Include the appropriate scheme, such as http, ftp, or https, at the beginning of URLs or URIs. That is, use http://www.redhat.com and not www.redhat.com.
 				</para>
 				 <para>
 					Refer to <xref linkend="other-websites" /> for more information.
