This page is a work in progress and still a draft
Overview
1. General notes
- Our source language is EN-US (US English)
- Remember to hand off designs to the Localization team
- Confluence Localization Operations Team / Slack #prj-translations
2. Engineering notes
- Where manually-created content needs to be formatted correctly in the code, use the relevant guidelines shown in this documentation
Numbers
LIVE CODE BLOCK PLACEHOLDER
Sequence and formatting
- Follow the local convention for style, punctuation, and sequence
- For smaller numbers (less than 1 million) we recommend writing numbers with digits, not words, as they're generally easier to understand
- Exceptions: Consider writing out a number with words if
- it's part of a proper noun
- it makes the phrase clearer (if in doubt, check with the Content Design team)
- it’s an ordinal number
- For example, 3rd should be written as third
- it makes the phrase clearer when citing large, round numbers
- For example, 3 million, 81 million, 2.5 billion, 7 trillion
- For numbers with 4 or more digits, use commas between every group of 3 digits starting from the right (breaking up numbers with commas improves readability)
- Don’t use abbreviations such as 130k or 130K (we can’t assume all audiences understand these abbreviations)
DO
- Coca-Cola Zero Sugar
- Two-factor authentication
- First choice
- One-time offer
- One in a million
- 16,000
- 16,503,233
DON'T
- Coca-Cola 0 Sugar
- 2-factor authentication
- 1st choice
- 1-time offer
- 15k
- 78033356534
- 1300
Decimals
LIVE CODE BLOCK PLACEHOLDER
- Follow the local convention for style, punctuation, and sequence
- Display decimals
- Don’t round up or down
- Don't use fractions like ½
- If an amount is less than one, insert a zero before the decimal point
- If a decimal equals zero, drop the decimal
- If a number is part of a monetary amount, go to Foundations>Currency for formatting details
DO
- 26.5
- 0.99
- 7.6
DON’T
- 26 1/4
- 43 ½
- 99.00
- 7.60
Percentages
LIVE CODE BLOCK PLACEHOLDER
- Follow the local convention for style, punctuation, and sequence
- Use the % symbol
- Don’t spell out percent
- Use the format [value][percent symbol]
- Don't include a space between the number and “%”
DO
- 6.5%
- 20%
DON’T
- 6.5 %
- 20 percent