A - .. glossary:: about on :icon-fa4:`exclamation-triangle` Don't use *on* to mean *about*. .. example:: Use *information about*, not *information on*. Don't use *about* to mean *approximately*. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - Help provides information about the console. - Help provides information on the console. *(This ambiguous sentence could mean that the information is displayed on the console.)* * - The installation takes approximately 10 minutes to complete. - The installation takes about 10 minutes to complete. abort :icon-fa4:`times-circle` Don't use. Instead, use words like *stop*, *exit*, *cancel*, or *end*. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - If the program seems to be looping, end it. - If the program seems to be looping, abort it. above :icon-fa4:`exclamation-triangle` Don't use *above* to locate information within a topic or a deliverable or to refer to releases or product versions. To locate information, use *preceding* or provide a specific link or cross-reference. To refer to releases or product versions, use *later*. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - The preceding commands create a **/etc/sysconfig/iptables** flat file with human readable syntax that can be manually edited. - The above commands create a **/etc/sysconfig/iptables** flat file with human readable syntax that can be manually edited. * - Follow the same process described in "Obtaining the metadata information via the Cloud Servers API (Examples)." - Follow the same process described above. * - To configure a custom error page for 3.5 SP1 and later, follow this example. - To configure a custom error page for 3.5 SP1 and above, follow this example. access (v) :icon-fa4:`times-circle` Avoid when you can in favor of friendlier words like *see*, *edit*, *find*, *use*, or *view*. accessible :icon-fa4:`exclamation-triangle` Use *accessible* only to refer to things that all people, including those with disabilities, can easily use. Don't use it to mean *simple* or *open*. add-on Hyphenate this term when using it as a noun or adjective. Don't use *add on* or *addon*. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - Entourage 2008 Web Services Edition is a free add-on to Entourage 2008 provided by Microsoft. - ad hoc Use as two words. Don't hyphenate *ad hoc*, even when it's used as a modifier (for example, *ad hoc tasks*). admin administrator administer administrative - Use *admin* in code as needed, such as ``role: "admin"``. - Use *administrator* in descriptive content, such as "The administrator of the accounts". - Use *administer* when a verb form is needed. Do not use *administrate*. For example, "Kelly administers the accounts processes for that customer." - Use *administrative* as ad adjective before a noun, such as *administrative role*. affect effect Use *affect* as a verb to mean influence, change, or have an effect on. Use *effect* as a noun to mean the result of an action or the power to bring about a result. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - Any change in network latency between primary and DR locations can potentially affect RPO because of the impact on data replication. - * - The open cloud has a long-term effect on innovation. - after once Use *after* to mean occurring subsequently in time or order. Use *once* to mean one time. Don't use *after* to refer to the location of information. Instead, use *next*, *follows*, *following*, or provide a specific cross-reference. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - After you create a volume, you can't resize it. - Once you create a volume, you can't resize it. * - The client ID is generated once, and it persists between restarts of the client. - * - You can resize the server, change the image, or add a record by selecting the option that follows the description for each setting. - You can resize the server, change the image, or add a record by selecting the option that appears after the description for each setting. afterward Use instead of *afterwards*. all caps :icon-fa5:`trash-alt` Use *uppercase* instead. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - Commands are written in uppercase to distinguish them from field names and other data. - Commands are written in all caps to distinguish them from field names and other data. allow :icon-fa4:`exclamation-triangle` Use *allow* only when discussing permission. Avoid using *allow* to imply that a program, feature, or product permits a user to do something. Use *you can* instead. *Enables* is also acceptable. This restriction also applies to *let* and *permit*. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - By default, network policies don't allow inbound access from the Internet to your cloud servers. - * - You can use Cloud Block Storage to expand the storage capacity of your cloud server. - Cloud Block Storage allows you to expand the storage capacity of your cloud server. alternate alternative Use *alternate* as a verb to refer to performing by turns or changing from one state to another state repeatedly. Use *alternative* as a noun or adjective to mean a choice between two things, such as alternative methods. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - If your system doesn't receive information from clients in a timely manner, results alternate between error messages and successful data collection. As an alternative method, you can right-click the table and select a command from the menu. - AM PM Show in uppercase, with no periods after each letter, and a space before. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - Between 8:00 AM and 5:00 PM - Between 8:00 a.m. and 5:00 p.m. among between When referring to three or more persons or items or when the number is unspecified, use *among*. When referring to two persons or items or when referring to the relationship between two items at a time, use *between*. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - To learn more about the differences between IMAP and POP, see the following article. - If you're new to Linux, you have to choose among unfamiliar distributions. Acting as an abstraction layer between a guest OS and the physical hardware, the hypervisor must juggle physical resources among multiple competing consumers. and/or :icon-fa5:`trash-alt` This construction is ambiguous and doesn't exist in other languages. For clarity, use one of the following constructions: - To indicate that one alternative or another is acceptable, use *or*. - To indicate multiple alternatives, use a list. - To indicate that two alternatives are acceptable, either separately or combined, use *or both*. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - If you're using the Cloud Servers API to create cloud servers, you can use API options to create servers without the PublicNet network or the ServiceNet network. - If you're using the Cloud Servers API to create cloud servers, you can use API options to create servers without the PublicNet and/or ServiceNet network. * - you're now ready to complete one or more of the following tasks: - Create a profile - Modify the sample files - Generate a job - you're now ready to create a profile, modify the sample files, and/or generate a job. * - From this window you can edit the job, schedule it to run later, or both. - From this window you can edit the job and/or schedule it to run later. Android Use initial caps. Never use *android*. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - Android-powered device - android-powered device anti (prefix) Don't hyphenate words that begin with the prefix *anti* unless the root word starts with an *i* or a capital letter. If you have a question about a particular word, look it up in a dictionary. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - antivirus, antispam, antispyware, anti-intelligence - any time Use *any time* as a noun. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - You can change this setting at any time. - anytime Use *anytime* as an adverb. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - Anytime you want a good video, you can watch YouTube. - API APIs Use *API* to refer to either an API for a service or a language-Specific API. Don't use it when referring to a method or a class. The plural form of API is APIs, not API's. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - Use the API for Cloud Servers when you need a feature that is not available in the Control Panel. - Don't write "This resource has one API" when you mean "This resource has one method." app Use *app*, not *application*, in most cases. appear Unlike *display*, *appear* doesn't require a direct object. You can use *appear* instead of *is displayed* if the context is appropriate. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - A message appears. - * - The system displays a message. - appendixes As the plural of *appendix*, use *appendixes* rather than *appendices*. application :icon-fa5:`trash-alt` Instead, use *app*. The industry trend is toward *app*. It's okay to use *application* as part of a common phrase such as *application programming interface*, but in general usage, *app* is preferable. architect architected :icon-fa5:`trash-alt` Use *architect* as a noun only. For a verb, use *design*, *create*, *plan*, or another appropriate verb. Don't use *architected* as an adjective, use *designed* or another appropriate word. argument :icon-fa5:`trash-alt` In a command-line context, use *option*. as since :icon-fa4:`exclamation-triangle` Don't use *as* or *since* when describing the reason for a situation, event, and so on. Use *because* instead. Use *since* only to express an interval, not causality. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - Because the utility failed, you can't complete the transaction. The status hasn't changed since the error occurred. - Since the utility failed, you can't complete the transaction. as a service This can be used as *infrastructure as a service (IaaS)*. Note the capitalization of the spelled-out term and the abbreviation. On first occurrence, use the spelled-out term and introduce the abbreviation in parentheses. Use the abbreviation thereafter. as per :icon-fa5:`trash-alt` Use *according to* instead. assure :icon-fa4:`exclamation-triangle` Use *ensure* to mean make certain of an action, event, or outcome. Don't use *assure* (to set someone's mind at ease) to convey this meaning. at scale Don't use *at-scale*. auto (prefix) - Don't hyphenate words that begin with the prefix *auto* unless it's necessary to avoid confusion. - Don't make up words that start with *auto*. When in doubt, use *automatic* or *automatically* instead. - Don't use *auto* as an abbreviation for *automatic* or *automatically*, unless you are referring to a label on a UI. If you have a question about a particular word, look it up in a dictionary. .. list-table:: :widths: 50 50 :header-rows: 1 * - Recommended - Not Recommended * - You can access the autoconfiguration tool to set up your Outlook email client. - You can access the auto configuration tool to set up your Outlook email client. * - The installation automatically starts the service. - The installation auto starts the service.