Skip to content
The style guide is in beta: content and structure may change.

Word list — R

Verdict: style

Always hyphenate.

Verdict: style · Form: adjective

Hyphenate read-write as a modifier before a noun. Otherwise, spell it out as read and write so the slash never stands in for a word.

  • Replacements: read-write, read and write

Verdict: avoid

Editing jargon from print production. Use mark up or revise for the intended action.

Verdict: avoid

Use regular expression instead.

  • Replacements: regular expression

Verdict: avoid

Use repository instead.

  • Replacements: repository

Verdict: avoid

Use REST instead of RESTful or Representational State Transfer.

  • Alternatives: RESTful
  • Replacements: REST

Verdict: avoid

Use a plain alternative, such as broken or slow, instead.

Verdict: acceptable

Use review for the act of deliberately evaluating a resource.

Verdict: acceptable

Use the abbreviation RFC. It is standard and widely recognized.

Verdict: style

Use rightmost.

Verdict: restricted

Use rights for a broad or legal entitlement to do something, such as usage rights or a person’s rights under a regulation. For technical access control, name the specific permissions or access instead, because rights alone is too vague to tell the reader what is actually allowed.

Verdict: restricted

Only use for the process of deploying a release. Use roll out for the verb and rollout for the noun.

Verdict: avoid

Hostile and inappropriate. Instead, point readers to the documentation directly.

Verdict: style

Use runbook.

Verdict: style

Use runtime to refer to an environment that runs software and services. Use run time to refer to a period of time during program execution.

  • Alternatives: run time