Table of Contents

Write using the same, everyday words you use in conversation. If used thoughtfully, contractions sound natural and relaxed and make reading more enjoyable.

  • Always use common contractions, such as it’s, you’re, that’s, and don’t, to create a warmer, friendlier tone.
  • Don’t mix contractions and their uncontracted equivalents in the UI, documentation, or other written collateral.
  • Never form a contraction from a noun and a verb, such as BriteCore’s developing a lot of new services.
  • Never use cannot.

Note: It’s okay to form contractions from pronouns and verbs, such as he’s, she’s, we’re, they’ve. Exceptions are noted below.

  • Avoid ambiguous or awkward contractions, such as there’d, it’ll, and they’d.
Contractions you need to use

Table 1: Common contractions acceptable to use in documentation.

-n'tnotAren’t, can’t (never cannot), couldn’t, didn’t, doesn’t, don’t, hadn’t, hasn’t, haven’t, isn’t, shouldn’t, weren’t, won’t, wouldn’t
-r'eareThey’re, we’re, you’re
-'sisHe’s, let’s, she’s, that’s, there’s, what’s, where’s, who’s

Reminder: Don’t form a contraction from a noun and a verb. Pronouns (he, she, it, etc.) are acceptable.
-'vehaveThey’ve, you’ve, we’ve, I’ve

Exception: Don’t use what’ve or who’ve; they sound awkward. Consider rewriting 've contractions and have phrases in active voice when applicable.
Contractions you won’t use

Don’t use these contractions; they’re either archaic, confusing/ambiguous (for example, they’d could mean they would or they had; it’ll could mean it will or it shall), or too informal (…BriteCore features that’re used the most…). Some simply sound or look awkward. Always use your best judgment to avoid uncommon, colloquial, confusing, or dated words.

Table 2: Contractions to avoid in documentation.

-'dHad, wouldThey’d, it’d, you’d, we’d, I’d, he’d, she’d
-'llWill, shallThey’ll, it’ll, you’ll, we’ll, I’ll, he’ll, she’ll, how’ll
Exceptions to -n'tnotMayn’t, mustn’t, mightn’t, shan’t, oughtn’t
Exceptions to -'reareThat’re, there’re, these’re, those’re, what’re, where’re, which’re, who’re, why’re, how’re, any noun + -’re
Double contractionsVariesCouldn’t’ve, mustn’t’ve

Table of Contents