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.
On subsequent uses in a document, favor the most commonly-used form and use discretion to favor readability. For example, “HTTP” is much more common than “Hypertext Transfer Protocol” (18 billion Google search results vs. 7 million, respectively).
Use title case for headers, titles, and link titles.
Use sentence case for items in bulleted and numbered lists.
Capitalize the following terms:
Lower case regular nouns, like load balancer, volumes, projects, reserved IP, and control panel.
For companies, organizations, software, and similar things, use the capitalization of the project. UNIX was first developed in the 1970s. systemd runs as PID 1.
Match the captalization of commands, even at the beginning of sentences and when otherwise using title case. How to Check File System Consistency with fsck
Use in-line code
for IP addresses, domains, commands, and package names.
Do not use in-line code formatting in headers.
Use first-person plural (we) when speaking as the author or as the voice of DigitalOcean.
Use second-person singular (you) when addressing the user.
Use title case for headers, titles, and link titles.
Use the singular of product names (e.g. Droplet Overview instead of Droplets Overview), except for Spaces.
Use hyphenated compound modifiers. The file has DigitalOcean-specific syntax.
Use suspended hyphens. Expect low performance from two- or three-node clusters.
Use hyphens for ranges. Third-party tools support uploading 2-10 files at once.
Use a single space to separate sentences.
Use a space to separate numbers and units. The file size limit is 500 MB.
Use “control panel” or “DigitalOcean Control Panel” to refer to cloud.digitalocean.com
.
Use an address in the blocks reserved for documentation as per RFC-5737 for IPv4 and RFC-3849 for IPv6. Specifically, we use:
203.0.113.0/24
for example public IPv4 addresses198.51.100.0/24
for example private IPv4 addresses2001:DB8::/32
for example IPv6 addressesUse example.com
, example.net
, example.org
, or example.edu
for documentation as per RFC-2606
Use use_your_<variable>
with in-line code formatting when indicating when the user should substitute their own value in a command. For example, use_your_droplet_ip
or use_your_domain
.