Industry word list

This page offers terminology guidelines for Dynatrace content developers. While these terms aren't specific to Dynatrace, they appear frequently in Dynatrace content. This is neither a dictionary or a glossary but rather a guide to correct usage.

For general writing guidelines and guidance on words that aren't included in this list, see the Microsoft Style Guide. For questions that aren't addressed by Microsoft Style, see The American Heritage Dictionary or the Chicago Manual of Style.

affect, effect

Most commonly, "affect" is a verb and means to influence or cause change. "Effect" is a noun and is the result of a change.

✅ This might affect performance.
✅ The change affects everyone.
✅ This might have an effect on performance.
✅ The effects of the changes were dramatic.

after

Use "after" in place of "once."

✅ After you install the software, you can adjust the settings.
❌ Once you install the software, you can adjust the settings.

agent

As a general rule, avoid the word "agent" in place of "OneAgent."

✅ OneAgent
✅ OneAgent for Mobile
❌ PHP agent, JavaScript agent, Mainframe Agent, OS agent

Also see RUM JavaScript.

AI, AIOps

✅ AI
✅ AIOps
✅ artificial intelligence
✅ artificial intelligence for IT operations

Also see Davis AI.

alert, alerting

An alert is a signal condition within a scope that requires timely action from a notified user or an automation.

✅ Create an alert.
✅ Create a ready-made alert.
❌ Create an out-of-the-box alert.
✅ Edit the alert.
❌ Edit the alert rules.
✅ Alerts trigger notifications when defined metric thresholds are breached.
❌ Alerts trigger "alerts" when defined metric thresholds are breached.
✅ Edit the alert to control when notifications are triggered and sent via Slack.
❌ Edit the "notification" to control when "alerts" are sent via Slack.

although

Use "although" in place of "while" as a conjunction to denote "in spite of the fact that."

✅ Although many observability tools are available, only Dynatrace leverages hypermodal AI.
❌ While many monitoring tools are available, only Dynatrace leverages AI.
✅ Although proper planning takes time, it's worth the effort.
❌ While proper planning takes time, it's worth the effort.

Also see while.

and

Avoid using an ampersand (&) in place of "and" except where necessary due to space limitations or when specifically needed as a design element.

✅ Support and services
❌ Support & services
❌ Support and/or services

app, application

• As a general guideline, use "app" when referring to a mobile app or a small application that runs on a platform.
• Use "app" to refer to Dynatrace Apps or third-party apps developed for the latest Dynatrace. Avoid adding the word "app" following the mention of an app name. Wherever possible, only use the app name.
• Use "application" when referring to web, mobile, or custom applications monitored by Dynatrace Real User Monitoring.

Application Performance Management (APM)

✅ Application Performance Management
❌ Application Performance Monitoring

autodiscovery

❌ auto-discovery

backend

✅ backend (noun)
✅ back-end (adjective)
❌ back end

backward compatible

✅ This release is backward compatible with previous releases.
✅ This is a backward-compatible release.
❌ backwards compatible

because

Use "because" when modifying a verb; use "due to" when modifying a noun.

✅ The monitor failed because the credentials were invalid.
✅ Monitor failure was due to invalid credentials.

Use "because" in place of "since" or "as" to denote causality.

✅ The data was lost because the settings are incorrect.
✅ The errors are due to recent system changes.
❌ The data was lost as the settings are incorrect.
❌ Performance has not improved since there are other issues that need to be addressed.

behavior

❌ behaviour

BizDevOps

blacklist

This word is forbidden in all cases.

• Suggested replacement

  ✅ blocklist

• Other options

  ✅ exclusions
  ✅ exclude list
  ✅ denylist
  ✅ reject list

BOSH

✅ BOSH release

button

• Use "select," not "click," when describing interaction with the product UI.
• Mention the control label (the name of the control); avoid mentioning the word "button" wherever possible.

✅ Select Install now.
❌ Select the Install now button.

Also see select.

can, may, might

Use "can" to express ability and use "might" (not "may") to express possibility. Use "may" only if you are speaking of providing permission.

✅ You can install the software.
✅ The system might fail.
✅ You might encounter errors.
✅ You may now proceed with the installation.
❌ You may install the software.
❌ You may encounter errors.
❌ It may happen that errors occur.
❌ Errors may occur.

can't, don't, won't

In general, use contractions whenever possible because they mimic conversational speech. Negative contractions (for example, "can't" and "isn't") are acceptable but, sometimes, can reduce comprehension by some international audiences. For imperative statements or caveats in documentation, use the full form instead of a negative contraction, for example, "do not" in place of "don't." Don't use uncommon or easily misunderstood contractions.

✅ Small companies often don't have enough cash reserves.
✅ If reports are disabled for a dashboard, you can't subscribe to it.
✅ It won't affect performance.
✅ Do not use a proxy when communicating with these hosts.
✅ JavaScript errors do not lead to monitor failure.
❌ mustn’t, shan’t

For more details, see Contractions.

catalog

❌ catalogue

center

❌ centre

checkbox

✅ checkbox
❌ check box

• Mention the control label; avoid mentioning the term "checkbox" where possible.
• Use "select" and "clear" with checkboxes, not "turn on/turn off," "mark/unmark," "check/uncheck," or "select/deselect."

✅ Select Restart.
✅ Clear Restart.
❌ Deselect the Restart checkbox.
❌ Check Restart.
❌ Uncheck Restart.

click, select

Use "click" only when referring to mouse actions. Otherwise, use "select," which works for all device types.

✅ Select <button label>.
✅ Select <checkbox label>.
✅ Select <radio button label>.
✅ Right-click <button label>.
✅ Double-click <button label>.
✅ Hover over the image and click with your mouse.
✅ Select <button label> on your mobile device.
❌ Click <button label> on your mobile device.

Also see select and button.

clickpath

✅ clickpath
❌ click path

Also see browser monitors.

cloud

Use lowercase "cloud" for general statements. Use uppercase "Cloud" where required as part of a product name.

✅ cloud components, cloud monitoring, cloud infrastructure
✅ SAP Cloud Platform, Cloud Foundry

code-level visibility

code-level vulnerabilities

color

❌ colour

command line, command-line

✅ command-line parameter
✅ command-line tool
✅ command line interface (CLI)

configure, configuration, adjust

Configuration is the process of arranging or connecting software components for a specific use in a specific environment, including the adjustment of available settings for installed software. Configuration is typically a part of the software installation process. When settings are changed following release of software into production, use adjust in place of configure.

✅ Your success depends on how you configure your environment settings and workflow rules before deployment.
❌ Your success depends on how you adjust your environment settings and workflow rules before deployment.
✅ You can adjust the settings in the future if you change your mind.
❌ You can configure the settings in the future if you change your mind.

container

container orchestration

containerization

data

✅ The data is overwhelming.
✅ There is less data on current trends.
❌ The data are overwhelming.
❌ There are fewer data.

data center

✅ data center
❌ datacenter
❌ DC

deploy, deployment, redeploy

Deployment encompasses all aspects of making software or resources available to consumers in a specific environment. Software deployment includes software installation, configuration, and rollout to end users.

✅ Deploy Dynatrace OneAgent® in your hybrid infrastructure for end-to-end observability.
❌ Install Dynatrace OneAgent® in your hybrid infrastructure for end-to-end observability.
✅ The company will deploy a new issue-tracking system.
❌ The company will install a new issue-tracking system.
✅ Based on shifting dynamics, we need to redeploy resources.
❌ Based on shifting dynamics, we need to re-deploy resources.

DevOps

Short for Development + Operations

✅ DevOps
❌ devops

digital transformation

Early Adopter release

✅ Feature X is now available as an Early Adopter release.
✅ Feature X is now available in an Early Adopter release.
✅ EA (abbreviation when space is limited)
❌ EAR
❌ Early Adopter Release
❌ Early adopter release

email

✅ email
❌ e-mail
❌ E-mail
❌ Email

endeavor

❌ endeavour

environment, tenant

Use "Dynatrace environment" when referring to the Dynatrace monitoring environment. Do not use "tenant" to refer to a Dynatrace environment.

✅ Set up your Dynatrace environment with custom workflows, dashboards, notifications, and more.
❌ Set up your Dynatrace tenant with custom workflows, dashboards, notifications, and more.

example, for example

✅ For example, if you...
✅ This could be useful when, for example, you have...
✅ Example 1:
✅ In this example,...
❌ e.g.,

Also see such as, for example, including.

favorite

❌ favourite

file format extensions

Use uppercase when referring to a file extensions, for example, "JSON" or "YAML."

✅ Download the ZIP file.
✅ Upload the JSON file.
✅ Download file.zip to your local machine.
❌ Download the .zip file.
❌ Download the json.

frontend

✅ frontend (noun)
✅ front-end (adjective)
❌ front end

General Availability (GA) release

✅ The General Availability release of this feature will be available with Dynatrace version 1.290.
✅ The new filters will reach GA in March 2024.
✅ Dynatrace version 1.285 is now generally available.
❌ The new filters go GA in March 2024.
❌ General Availability Release

gathers

Where appropriate, use "gathers" rather than "aggregates" for a less formal tone.

✅ OneAgent gathers monitoring data from each monitored host.
❌ OneAgent aggregates monitoring data from each monitored host.

have to

See need to.

hostname

✅ The hostname is a fully qualified domain name.
❌ Each host is identified by a host name.

however

When used to denote "yet" or "on the other hand," "however" is typically followed by a comma (,).

✅ It's usually fast and reliable. However, if you have...
✅ In some cases, however, the...

hyperscale

ID

Abbreviation of identifier

✅ ID
❌ Id
❌ id

Identity and Access Management (IAM)

Pronounced "I am" or "I. A. M."

✅ Identity and Access Management
✅ IAM

Infrastructure as a Service (IaaS)

install, installation

Installation encompasses all steps involved in making software available for use in a specific environment, including the copying of software to the target location via an installer and the configuration of available software settings based on organizational requirements.

✅ Before installing OneAgents on your hosts, configure the installer settings.
❌ Before deploying OneAgents on your hosts, configure the installer settings.
✅ Install the browser plugin.
❌ Deploy the browser plugin.

installer

An installer is a software component or file that is used to copy software to a target location.

✅ Run the installer to install the software and configure the available settings.
❌ Run the executable to install the software and configure the available settings.

internet

✅ Search the internet.
❌ Search the Internet.

it's, its

Short for "it is"—do not use to indicate possessive case.

✅ It's easier to learn this way.
❌ It is easier to learn this way.
✅ Each instance has its own identifier.
❌ Each instance has it's own identifier.

Java

✅ Java
❌ java

JavaScript

✅ RUM JavaScript
❌ javascript
❌ Javascript
❌ JS

Also see RUM JavaScript.

left, right, upper, lower

✅ lower left (noun)
✅ lower-left (adjective)
✅ lower right (noun)
✅ lower-right (adjective)
❌ bottom right
✅ upper left (noun)
✅ upper-left (adjective)
❌ top left
✅ upper right (noun)
✅ upper-right (adjective)
❌ top right
✅ lower-left corner
❌ bottom left
✅ upper-right corner
✅ leftmost
✅ on the left side
❌ left-hand side
✅ rightmost
✅ on the right side
❌ right-hand corner

Avoid referring to the "top" or "bottom" of a web UI or webpage.

✅ Go to the user menu in the upper-right corner of the page.
❌ Go to the user menu at the top of the page.
✅ Scroll to the top of the page.
✅ Scroll to the bottom of the page.

less, fewer

When comparing quantities:

• Use "less" to refer to an amount, value, or degree.
• In most cases, use "less" in reference to time, even though we can count time.
• Use "fewer" to refer to a countable number of items.
• Don't use "under" to refer to a quantity or number.

✅ Create an app in less than five minutes.
✅ The new building has less floor space and contains fewer offices.
✅ The new building has fewer square feet of floor space and contains fewer offices.
✅ Fewer than 75 members were present.
✅ Less than a quorum attended.
❌ Create an app in under five minutes.

lifecycle

list, dropdown list

In most cases, mention the control label and avoid talking about UI elements such as "list" or "dropdown list."

✅ Select Widgets to expand the list.
✅ Select a widget from Widgets.
✅ Select a widget from the Widgets list.
✅ Select a widget from the Widgets dropdown list.
❌ Select a widget from the Widgets drop-down list.
❌ Select a widget from the Widgets drop list.

master

Avoid this word wherever possible.

While the word "master" on its own (in the absence of "slave") isn't strictly forbidden, you should make every effort to replace it with a synonym below.

• Suggested replacements

  ✅ primary
  ✅ main
  ✅ hive

• Suggestions for people

  ✅ pro, maven, virtuoso, genius, wizard, authority, principal, controller, conductor, captain, guide, agency

• Relationships between people

  ✅ principal/agent, controller/worker, agency/agents, agency/operatives, captain/conscripts

• Suggestions for components

  ✅ primary
  ✅ original
  ✅ template
  ✅ hive

• Relationships between components

  ✅ primary/subordinate
  ✅ primary/replicas
  ✅ primary/secondary
  ✅ original/copies
  ✅ template/copies
  ✅ hive/drones

• Don't use "primary/subordinate" as a synonym for parent-child relationships.

  ✅ Each subordinate device has a unique 7-bit or 10-bit address.
  ✅ The architecture uses a standard primary/subordinate design to replicate data from one server to many.

menu

Precede the word "menu" by the menu label. Avoid using "menu" if the label alone is sufficient.

✅ Select Appearance in the user menu.
✅ Select Edit dashboard > Colors. Then choose a color.
❌ From the menu on the left, select...
❌ Open the top-left menu.

mobile devices, tablets

It's okay to use product names when discussing specific products, but don't use them as synonyms for entire product categories.

✅ mobile device
✅ tablet
❌ iPhone or iPad
❌ cell phone or mobile phone

multicloud

multidimensional

✅ multidimensional
❌ multi-dimensional

must

See need to.

native

Avoid this word wherever possible.

Avoid using "native" to refer to people. When referring to software products, try to use a more precise term (for example, use "built-in" to describe a feature that's part of a product).

The term "native" also isn't necessarily clear (for example, "cloud-native" could mean that something was written for the cloud, is built into a cloud platform, or that currently exists in a cloud platform).

need to

In nearly all cases, use "need to" in place of "must" or "have to." "Need to" indicates that something is required. "Must" indicates a strong, non-negotiable obligation. "Have to" indicates a non-negotiable externally-imposed obligation.

✅ For best results, you need to install a proxy.
❌ For best results, you have to install a proxy.
❌ For best results, you must install a proxy.

notification

A notification is a message sent to a Dynatrace user through a defined notification channel such as email, Dynatrace UI, Dynatrace mobile app, or third-party messaging system like Slack. Notifications typically don't require a timely response.

✅ Incident management systems offer a range of notification channels, inluding mobile push notifications.
❌ Incident management systems offer a range of "alerting" channels, including mobile push "alerts."
✅ The Dynatrace mobile app delivers push notifications for detected problems.
❌ The Dynatrace mobile app delivers "alerts" for detected issues.

observability

on-premises

✅ The software is installed on-premises.
❌ The software is installed on-premise.
✅ Dynatrace Managed features on-premises software deployment.
❌ Dynatrace Managed features on-premise software deployment.
❌ on-prem, onprem, on prem

open source

Use "open source" (unhyphenated) both as a noun or an adjective.

✅ open source software
❌ open-source software

OpenStack

OpenTelemetry

OpenTracing

organization

❌ organisation

page

As a web application, the Dynatrace web UI comprises "pages" (webpages), not "screens."

✅ Select Configure in the lower-right corner of the page.
❌ Click Configure in the lower-right corner of the screen.
❌ You'll find the details listed on the Applications screen.

Platform as a Service (PaaS)

please

Use only when asking the user to do something inconvenient or in response to a problem with our product.

✅ Please open a support ticket.
✅ Refer to Red Hat documentation for further details.
❌ Please install OneAgent.

plugin

Use "extension" instead of "plugin" or "add-on" for Dynatrace extensions listed in Dynatrace Hub. Exceptions include "Plugins API" and "Remote Plugin Module."

✅ You can find and delete relevant extensions via Dynatrace Hub.
✅ OneAgent extensions
✅ ActiveGate extensions
✅ Plugins API
✅ Remote Plugin Module
✅ Install the third-party plugin.
❌ OneAgent plug-in
❌ ActiveGate plugin
❌ ActiveGate add-on

note

Use the standard term for third-party platforms.

For Dynatrace integrations into third-party platforms, use the standard term for those platforms. Examples include:

✅ Dynatrace Android Gradle plugin.
✅ Dynatrace data source plugin for Grafana.
✅ Dynatrace extension for the Azure CLI.

pod

✅ pod (lowercase when referring generically to how containers and pods operate)
✅ Pod (uppercase when used in a product name such as Kubernetes Pods)

Preview, Preview release

✅ Preview release
✅ The following APIs are now available as Preview releases.
✅ The following APIs are now available in Preview.
❌ Preview Release

real time, real-time

✅ real time (noun)
✅ real-time (adjective)
❌ realtime

real user [data | monitoring | metrics]

No hyphen required, even when used as an adjective

recommend

✅ We recommend that you install a proxy.
✅ We do not recommend that you install a proxy.
❌ We suggest...
❌ Dynatrace recommends...
❌ It's recommended...

reinstall

✅ reinstall
❌ re-install

REST API, RESTful API

✅ REST API
✅ RESTful API
❌ Rest API

root cause analysis

No hyphen required

RUM JavaScript

✅ RUM JavaScript
✅ Real User Monitoring JavaScript
❌ JavaScript agent
❌ RUM JavaScript agent
❌ RUM JavaScript tag
❌ RUM JavaScript code

"RUM JavaScript" is an umbrella term that encompasses the injection formats listed below. Use the following terms only in the context of discussing injection formats for RUM JavaScript, RUM injection, or manual insertion.

✅ JavaScript tag
✅ OneAgent JavaScript tag
✅ Inline code
✅ Code snippet

Also see agent, OneAgent, and JavaScript.

runtime

Works both as a noun and an adjective.

✅ runtime
❌ run-time
❌ run time

see

Use "see" when providing references to internal Dynatrace or external resources.

✅ See <Topic title>.
✅ See <Topic title> in Dynatrace Documentation.
❌ Refer to <Topic title>.
❌ For details, go to <Topic title>.

select

✅ Select Install now.
❌ Click Install now.
❌ Click the Install now button.
✅ Right-click Install now. (mouse actions only)

For more details, see Interactions with web UI controls.

service-level [objective (SLO)][agreement (SLA)]

❌ service level objective (SLO)
❌ service level agreement (SLA)

set up, setup

• Two words as a verb; one word as an adjective and a noun
• Use as a verb to describe the process of preparing hardware and installed applications for initial use.
• Don't hyphenate.

✅ Unpack everything before you set up your computer.
✅ The setup time is about 15 minutes.
✅ Your office setup should be ergonomically designed.
❌ Now you can setup your environment.
❌ Now you can set-up your environment.

shift-left, shift left

• Include a hyphen when using this phrase as an adjective.
• Don't include a hyphen when using this phrase as a verb.

✅ shift-left testing
✅ Shift left to save costs.

slash, backslash, forward slash

Don't use slash symbols to indicate and/or. Note the use of backslashes and forward slashes in paths on Windows and Linux.

✅ C:\Windows\ (Windows backslash)
✅ /home/user/ (Linux forward slash)
❌ The software will be released around October/November.

slave

This word is forbidden in all cases.

• Suggested replacement

  ✅ subordinate

• Other options

  ✅ node
  ✅ replica

Software as a Service (SaaS)

such as, for example, including

Each of these phrases can be acceptable, though "for example" followed by a comma is usually the best option in Dynatrace language. Avoid "for instance."

✅ There are options to consider, such as the launch date.
✅ There are options to consider, including the launch date, the launch site, and publicity.
✅ For example, you need to consider the output format.
❌ Let's say, for instance, that you've discovered a bug in your code.
❌ (e.g., Windows and Linux)

Also see example, for example.

support

✅ Dynatrace supports a variety of different flavors of AWS EKS.
✅ Dynatrace supports version x.xx+.
✅ Dynatrace version x.xxx is the last version that supports version x.xx.
✅ Version x.xx is no longer supported.
✅ Dynatrace support for version x.xx ends on June 1, at which time the tool will reach end of life (EOL).
❌ Version x.xx is now unsupported.
❌ Version x.xx has been desupported.

switch

• It's okay to use "switch" as a noun to refer to a CLI or compiler options, such as /Za.
• As a verb, use "switch" in place of "activate" or "toggle".

✅ Select Alt+Tab to switch between open windows.
❌ Select Alt+Tab to toggle between open windows.

Also see turn on, turn off and toggle.

that, which

Include "that" at the beginning of a clause that’s necessary for the sentence to make sense. Use "which" at the beginning of any clause that adds supporting or parenthetical information and place a comma before it.

✅ The host that isn't responding won't be included in the report.
✅ This host, which currently isn't responding, won't be included in the report.
✅ Extensions that can save you time include...
✅ Extensions, which can save you time, include...
✅ To learn more about features that aren’t supported in the trial version, see the chart.
✅ The chart shows which features aren't supported.
✅ The chair in my kitchen that has a broken leg is dangerous to sit on.
✅ The human heart, which contains four valves, weighs approximately eleven ounces.
❌ The chair in my kitchen which has a broken leg is dangerous to sit on.
❌ The human heart, that contains four valves, weighs approximately eleven ounces.

that is

Use "that is" (rather than "i.e.") to denote "in other words." The phrase should be followed by a comma. Omit the phrase if the context is clear.

✅ To monitor the entire environment (that is, all components), install Dynatrace.
❌ To monitor the entire environment (i.e., all components), install Dynatrace.

their, them, they

Use "their," "them," and "they" instead of "he," "she," "his," or "her."

✅ Then the user can install their software.
✅ <user name> has paused their notifications for a bit, but they'll see your message when they're back.
✅ If your user has sufficient privileges for the token, the software will provide it to them.
✅ Now the user needs the token that they downloaded.
❌ Then the user can install his or her software.
❌ If your user has sufficient privileges for the token, the software will provide it to him or her.
❌ Now the user needs the token that he or she downloaded.

For more details, see Inclusive language.

third-party, third party

Spell out as two words. Hyphenate as an adjective.

✅ You can license third-party software.
✅ A third party owns the company.
❌ 3rd-party
❌ 3rd party

time series

❌ timeseries

time to value

time-out, time out

Spell out as two words. Hyphenate as an adjective; don't hyphenate as a noun.

✅ Set the time-out period.
✅ The request times out.
✅ The connection timed out.
✅ If your applications time out before a response is received...

timeframe

One word, to refer to a duration of time

✅ timeframe
❌ time frame

timestamp

One word as a noun or a verb

✅ Each log entry has a timestamp.
✅ Each log entry is timestamped.
❌ time stamp

toggle

• Don't use as a verb. Use "switch" instead.
• Only use "toggle" when it's necessary to refer to a toggle-type UI control that doesn't have a clear label. In most cases, avoid using if the label alone is sufficient.
• Use "turn on" and "turn off" as a verb with toggle controls.

✅ Select Caps lock to switch from typing capital letters to typing lowercase letters.
✅ To switch between Normal, Outline, and Slide Sorter views, use the buttons on the View tab.
✅ Turn on the appropriate toggles to include underlying hosts and process groups.
✅ To keep all applied filters, turn on Pass all filters.
❌ To keep all applied filters, turn on the Pass all filters toggle.
❌ Select Alt+Tab to toggle between open windows.

Also see switch.

turn on, turn off

• Use when referring to turning a device on and off instead of "power on," "power off," "start," "stop," "switch on," or "switch off."
• Use when referring to a toggle control instead of "enable" or "disable."
• Use instead of "enable" and "disable" to refer to commands and features that can be hidden or deactivated.
• Don't use to refer to selecting or clearing checkboxes in instructions. Use "select" and "clear" for checkboxes instead.

✅ To turn on your device,...
✅ To turn off pop-up blocking,...
✅ If the button is grayed out, your network administrator might have turned off this feature.
✅ To keep all applied filters, turn on Pass all filters.
❌ To keep all applied filters, turn on the Pass all filters toggle.
❌ Your administrator must enable the feature flag toggle for this option to be available.

Also see checkbox and toggle.

use case

✅ Regardless of your observability use case, Dynatrace has you covered.
✅ Although Dynatrace provides a comprehensive digital experience solution, this use-case example might be of particular interest to you.

version

• Dynatrace has numbered release versions. Use a plus sign (+) to indicate "and later."
• Use "release" to refer to General Availability, Early Adopter, or Preview releases.
• Use "version" when referring to a Dynatrace version number.

✅ OneAgent version 1.151
✅ OneAgent version 1.151+ (OneAgent version 1.151 and later.)
✅ OneAgent version 1.151 and earlier
❌ OneAgent version 1.151 and later
❌ OneAgent release 1.151
❌ older, newer, higher, lower, above, below (to indicate earlier or later releases)

versus, vs

In headings, use the abbreviation "vs." (all lowercase). In text, spell out "versus."

✅ Automated vs. manual instrumentation (heading example)
✅ For details on how you can manage privileged versus non-privileged modes for OneAgent deployment,...
❌ For details on how you can manage privileged vs. non-privileged modes for OneAgent deployment,...

via

✅ Communication is handled via third-party integration.

we, you

• Use "we" when referring to actions Dynatrace has taken or when referring to the employees of Dynatrace.
• Don't use "we" when referring to functionality of our software.
• Address the reader as "you."

✅ We recommend that you adjust your privacy settings.
✅ Before proceeding, you need to configure privacy settings.
✅ Dynatrace analyzes all the data and dependencies for you.
❌ Dynatrace recommends...
❌ It's recommended...
❌ We analyze all the data and billions of dependencies for you.

Also see you, you've, you'll, you're.

web

Don't capitalize "web" unless it's the first word in a sentence, if the word is displayed standalone as a heading, or if the word is part of a name such as Amazon Web Services.

✅ web
✅ webpage
✅ website
✅ web application
❌ web page

while

Use only to refer to something occurring in time. Don't use as a synonym for "although," "whereas," "on the contrary," or "in spite of."

✅ We're having trouble getting this information right now. Check back in a little while.
✅ Although the icon indicates that the print job is done, you might have to wait while previous jobs are completed.
❌ whilst

Also see although.

whitelist

This word is forbidden in all cases.

• Suggested replacement

  ✅ allowlist

• Other options

  ✅ safelist
  ✅ allowed list
  ✅ inclusions
  ✅ permit list
  ✅ safe senders' list

you, you've, you'll, you're

Address readers in the second person with "you" and related contractions.

✅ You can configure the settings to meet your needs.
✅ Once you've installed the software, you'll be ready to start monitoring.
✅ Now you're ready to start monitoring.
❌ Customers must provide their own credentials.
❌ Once you have installed the software, you will be ready to start monitoring.

In many situations, Dynatrace users (referred to as "you") in turn have end users of their own (that is, the user's customers).

✅ You might need to notify your end users.

Also see we, you.

Words to avoid

slave

Forbidden in all cases

blacklist

Forbidden in all cases

whitelist

Forbidden in all cases

master

Strongly discouraged

native

Avoid where possible