diff --git a/en-US/Book_Design.xml b/en-US/Book_Design.xml index 6849ac1..a92191a 100644 --- a/en-US/Book_Design.xml +++ b/en-US/Book_Design.xml @@ -64,7 +64,7 @@
Prefaces - The brands that form part of Publican contain a preface as part of the common content. Whether your publication is for external Red 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 () contain a preface as part of the common content. Whether your publication is for external Red 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.
diff --git a/en-US/C.xml b/en-US/C.xml index ec4d3d2..69f34b3 100644 --- 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. - 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. @@ -443,8 +443,8 @@ cookie - n. A message given to a web browser by a web server. - The browser stores the message in a text file named cookie.txt. + n. 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 cookie.txt. The message is then sent back to the server each time the browser requests a page from the server. diff --git a/en-US/Design.xml b/en-US/Design.xml index 5a4c4ea..007118a 100644 --- a/en-US/Design.xml +++ b/en-US/Design.xml @@ -637,7 +637,7 @@ STEP 14: COMMIT ...output omitted... localhost/nexus:latest - As much as possible, leave the systemwide default as become: false or become: no and if a single task needs privileges, set become: true or become: yes on that task. + As much as possible, leave the system-wide default as become: false or become: no and if a single task needs privileges, set become: true or become: yes on that task. @@ -1043,7 +1043,7 @@ STEP 14: COMMIT ...output omitted... localhost/nexus:latest First Mentions 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. diff --git a/en-US/G.xml b/en-US/G.xml index 32e360a..8e06b79 100644 --- a/en-US/G.xml +++ b/en-US/G.xml @@ -30,13 +30,14 @@ GB - Abbreviation of gigabyte. Depending on the type of content you are writing, refer either to The AP Style Guide or the IBM Style Guide. + Abbreviation of gigabyte. + - + - IBM style: Use a non-breaking space between the value and the abbreviation. For example, "a 2 GB file". + Use a non-breaking space between the value and the abbreviation. For example, "a 2 GB file". diff --git a/en-US/Grammar.xml b/en-US/Grammar.xml index e882786..712e334 100644 --- a/en-US/Grammar.xml +++ b/en-US/Grammar.xml @@ -972,7 +972,7 @@ Split contractions and abbreviations into separate paragraphs. --> Hyphenate Complex Adjectives - 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. diff --git a/en-US/Language.xml b/en-US/Language.xml index 384d379..9ad6b78 100644 --- a/en-US/Language.xml +++ b/en-US/Language.xml @@ -527,7 +527,7 @@ low-hanging fruit - 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". @@ -1168,7 +1168,7 @@ Kubernetes is an open source system that makes it easy to manage containerized applications across multiple hosts. - Kubernetes is an open source system to manage containerized applications across multiple hosts. + Kubernetes is an open source system that manages containerized applications across multiple hosts. @@ -1238,8 +1238,8 @@ - Tab through the dialog box. Set the tab. Move the tab on the ruler. How to show or hide tabs. Select the tab. - 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 View tab in the Options dialog box. + Tab through the dialog box. Set the tab. Move the tab on the ruler. How to show or hide tab characters. Select the tab. + 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 /\t and noh commands. Select the View tab in the Options dialog box. diff --git a/en-US/S.xml b/en-US/S.xml index a05860f..7c72375 100644 --- a/en-US/S.xml +++ b/en-US/S.xml @@ -652,7 +652,10 @@ a programming and technical sense, it also means "Run the sourceSSL - 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 https: instead of http:. + 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 https: instead of http:. SSL later evolved into Transport Layer Security (TLS). + + + Refer also to . diff --git a/en-US/T.xml b/en-US/T.xml index dd11d8f..2f3cc59 100644 --- a/en-US/T.xml +++ b/en-US/T.xml @@ -187,6 +187,16 @@ + + + TLS + + + 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 https: instead of http:. + + + + token-ring diff --git a/en-US/Translation.xml b/en-US/Translation.xml index c59c81d..fff4ae9 100644 --- a/en-US/Translation.xml +++ b/en-US/Translation.xml @@ -42,7 +42,7 @@ 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. @@ -154,7 +154,7 @@ - Before you start the installation, follow these steps to ensure a smooth installation: + Before you start the installation, follow these prerequisite steps: @@ -625,13 +625,13 @@ - Troubleshooting Glance. - Troubleshooting the Glance image service. + Troubleshoot Glance. + Troubleshoot the Glance image service. - Installing the maven-changelog-plugin. - Installing the maven-changelog-plugin package. + Install the maven-changelog-plugin. + Install the maven-changelog-plugin package. diff --git a/en-US/U.xml b/en-US/U.xml index b63c408..a1ebb01 100644 --- a/en-US/U.xml +++ b/en-US/U.xml @@ -182,10 +182,10 @@ - URL + URL, URI - n. 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. + n. 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. Refer to for more information.