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
- We don't (yet) have a library that will localize the format of phone numbers. Features like
Intldo not support phone number formatting. - This means phone numbers will likely need to be formatted manually. Use the relevant guidelines shown in this documentation.
Phone numbers
- Follow the local convention for style, punctuation, and sequence
- Include 3-digit area code
- Place open and close parentheses before and after area code
- Insert a dash after the first 3 digits
- Don't include the country code (1 or +1)
- Users are on country-specific sites so there's no need to include it
- Don't insert any spaces
- For example, (XXX)XXX-XXXX, (818)433-5010
DO
- (212)867-5309
DON’T
- +1(212)867-5309
- 1.212.867.5309
- 212 867 5309
Input fields or error states
When phone numbers appear as part of a <text input field> or an <error state>:
- Include helper/hint text that shows the correct format
- More details on helper/hint text in Components>Forms>Guidelines
