diff --git a/en-US/Design.xml b/en-US/Design.xml index 200b473..b16fa86 100644 --- a/en-US/Design.xml +++ b/en-US/Design.xml @@ -688,7 +688,7 @@ $ vi myFile.txt
- Using Abbreviations, Acronyms, and Initialisms Correctly + Using Abbreviations, Acronyms, Initialisms, and Special Characters Correctly This section describes how to use abbreviations, acronyms, and initialisms correctly in Red Hat documentation. @@ -727,7 +727,7 @@ $ vi myFile.txt Be sure to use correct capitalization for acronyms. Not all acronyms are capitalized (for example, "spool"); see the IBM Style Guide or another suitable reference if you are unsure. - + Initialisms An initialism is an abbreviation that consists of the first letters of words in a phrase, syllables, or some combination thereof. Each character is pronounced separately. For example, FTP is an initialism for File Transfer Protocol. @@ -737,6 +737,24 @@ $ vi myFile.txt Consider pronunciation when using articles. See for more information. + + Special Characters + + Consider pronunciation when referring to file or directory names that begin with special characters, and use the correct indefinite article. + + + + + If a file or directory name begins with a special character, such as an underscore, then you need to pronounce that character. + + + + For example, using "an _build/ directory" is correct, because you pronounce "an underscore build directory". + + + + Using "a -compile/ directory" is correct, because you pronounce "a dash compile directory". +