diff --git a/en-US/B.xml b/en-US/B.xml index 31cf889..ed2bc30 100644 --- a/en-US/B.xml +++ b/en-US/B.xml @@ -382,7 +382,7 @@ See for more information on this file system. - See for a list of file system names and how to present them. + See for a list of file-system names and how to present them. diff --git a/en-US/Design.xml b/en-US/Design.xml index d355102..1caddc4 100644 --- a/en-US/Design.xml +++ b/en-US/Design.xml @@ -709,7 +709,7 @@ $ vi myFile.txt - 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. Choosing a Realistic Name @@ -1160,10 +1160,10 @@ $ vi myFile.txt Using Admonitions To call attention to a statement, use an admonition. - Red Hat technical documentation currently uses Note, Important, and Warning admonitions. + Red Hat technical documentation currently uses Note, Important, and Warning admonitions. - 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: @@ -1181,20 +1181,20 @@ $ vi myFile.txt - Use a Note admonition to bring extra information to the user's attention. + Use a Note admonition to bring extra information to the user's attention. - Use an Important admonition to show the user a piece of information that should not be overlooked. + Use an Important 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. - Use a Warning 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 Warning 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. diff --git a/en-US/E.xml b/en-US/E.xml index 343e765..6620c31 100644 --- a/en-US/E.xml +++ b/en-US/E.xml @@ -40,7 +40,7 @@ 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 emacs." 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 emacs." The complete and correct name is "GNU Emacs". @@ -64,7 +64,7 @@ When referring to the keyboard key, use Enter. If referring to the keyboard key on Solaris, use Return. - When referring to typing a command, use "type" instead, such as "To open Source-Navigator from the command line, type snavigator." + When referring to typing a command, use "type" instead, such as "To open Source-Navigator from the command line, type snavigator." When typing information into a single-field dialog box, "enter" means "type and press Enter". 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 index 4457d31..70bec9b 100644 --- a/en-US/Grammar.xml +++ b/en-US/Grammar.xml @@ -759,7 +759,7 @@ - The fsck /dev/vdb1 command performs a file system check on the XFS file system residing on the /dev/vdb1 partition. + The fsck /dev/vdb1 command performs a file-system check on the XFS file system residing on the /dev/vdb1 partition. The fsck /dev/vdb1 command checks the XFS file system on the /dev/vdb1 partition. diff --git a/en-US/Language.xml b/en-US/Language.xml index f7f15ee..2fa11a2 100644 --- 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 Hat Enterprise Linux 8, Linux kernel 4.18). - 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). See The Chicago Manual of Style, 17th Edition for detailed information on numbering formats. diff --git a/en-US/N.xml b/en-US/N.xml index ecac797..4feaff4 100644 --- a/en-US/N.xml +++ b/en-US/N.xml @@ -117,7 +117,7 @@ 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 ), 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 ), 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. diff --git a/en-US/New.xml b/en-US/New.xml index d35bcff..61c8f8d 100644 --- a/en-US/New.xml +++ b/en-US/New.xml @@ -41,7 +41,7 @@ Use "following" with a noun. - Avoid hyphenating with an "-ly" prefix: added an example. + Avoid hyphenating with an "-ly" suffix: added an example. If-Then statements. diff --git a/en-US/O.xml b/en-US/O.xml index 9cd08ac..80760ba 100644 --- a/en-US/O.xml +++ b/en-US/O.xml @@ -250,7 +250,7 @@ A phrase that was coined by the Red 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." 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 Open Source Initiative, to avoid diluting the legal meaning of the term "open source".