Numbers

When you include numbers in online content, use a consistent writing approach.

General

Commonly, single-digit, two-digit, and multi-digit figures follow different writing conventions.

Guidelines

• For integers between zero and nine, use words unless you are referring to a product name or version number. Note that for numbers in tables and other space-constrained places, you can use digits.

  Not that good	Much better
  Tap and hold with 3 fingers.	Tap and hold with three fingers.
  Starting with AppBuilder two-point-zero, you can develop hybrid apps by using custom plugins.	Starting with AppBuilder 2.0, you can develop hybrid apps by using custom plugins.
  You can now develop apps by using Angular Two.	You can now develop apps by using Angular 2.

• For integers greater than nine, use digits.

  Not that good	Much better
  The default timeout is one thousand milliseconds.	The default timeout is 1000 miliseconds.

• For decimals, use period-separated digits.

  Not that good	Much better
  An average of 10-point-6 seconds per operation.	An average of 10.6 seconds per operation.
  An average of 10,6 seconds per operation.	An average of 10.6 seconds per operation.

• For ranges, always use digits and an en dash (– in Markdown or HTML). Do not add intervals before or after the short dash.

  Not that good	Much better
  Valid values are in the range of one to 15.	Valid values are in the range 1–15.
  Provide a value between one and three.	Provide a value in the range 1–3.

• Do not begin sentences, titles, headings, or captions with a number. If you cannot rewrite the text element to not start with a number, spell out the number.

  Not that good	Much better
  3 Approaches to Good Documentation	Three Approaches to Good Documentation or Approaches to Good Documentation