Language

Validated on 4 Apr 2023 • Last edited on 17 Apr 2025

When in doubt, we default to the Microsoft style guide, but this style guide supersedes any guidelines from Microsoft.

The DigitalOcean community is bigger than just us; it’s truly global. Our content and our products — including Cloudways — help people all over the world to create. With that wide reach comes a huge responsibility for us to make inclusive content that’s accessible and clear to all people. We take that responsibility seriously.

Be thoughtful about your use of language and prioritize clarity over cleverness.

Acronyms
  • On first use in a document:

    • For well-known acronyms, use the acronym first. Favor putting the full word or phrase in parentheses after.

    • For acronyms that are not well-known, put the full word or phrase first and the acronym in parentheses after.

Considerate Language

Don’t use terms that may carry unconscious bias, sensitive subjects, or associations with military actions, politics, or historical events and eras. Use gender-neutral alternatives for common terms.

Dates and Times
  • Always spell out the name of the month in full.

  • Use “AM” and “PM” preceded by a space to denote times.

  • Don’t use ordinal numbers for dates.

DigitalOcean Products

How to talk about DigitalOcean and its products.

Domains and IP Ranges

Follow RFC-2606 (example.com/net/org/edu), RFC-5737 (203.0.113.0/24 and 198.51.100.0/24), and RFC-3849 (2001:DB8::/32).

Link Text

Link text describes where the link takes the reader or the benefit of clicking the link so they know what to expect when they follow it.

Links

Link text describes where the link takes the reader or the benefit of clicking the link so they know what to expect when they follow it.

Pronouns

Use the pronoun “they” to refer to either a group of people or an individual.

Verbs
  • Use verbs in the present tense, not future tense. Be definitive about what happens when the user takes an action.

  • Use descriptive verbs to reduce the wordiness of your sentence.

Word Choice

Slang and Colloquialisms

  • Don’t use idioms, slang, and colloquialisms as a central metaphor in your writing, and very sparingly aside.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.