Cloudflare Docs
Style Guide
Style Guide
Edit this page
Give us feedback
Set theme to dark (⇧+D)

Nouns and pronouns

Refer to the customer in the second person. Where this is not possible, use gender neutral pronouns. Do not use “one” as a pronoun.

Make sure it is clear who or what pronouns are in reference to. Pronouns act as signposts to the subject of the sentence and should not be used so much that the subject is no longer clear.

​​ First person

Substitute “we” or “I” with “Cloudflare” if you need to represent Cloudflare.

Cloudflare recommends you submit image or plain text files.We recommend closing your files before you restart your computer.

​​ Second person

When you give instructions, use the polite command form with the second person “you” or in special cases “they” or “it”.

​​ Referring to people

Use “you” instead of “the user” when the audience is the user of a Cloudflare product.

As a last resort, use passive voice if the subject is obvious or irrelevant.