diff --git a/FAQ.md b/FAQ.md index e29e9c79f..d1e6ff12c 100644 --- a/FAQ.md +++ b/FAQ.md @@ -253,6 +253,29 @@ It is true that in some countries phone numbers are typically written using native, not ASCII, digits; our phone number library supports parsing these but doesn't support it at formatting time at the moment. +### When does formatting in a country change? + +The formatting within a country changes sparingly, but may be announced explicitly +or noted implicitly in a national numbering plan update that introduces a new number +length, number type, or other significant change. This may include the grouping and +punctuation used (e.g. parentheses versus hyphens). + +In the event of lack of evidence and/or enforcement by a central government +regulatory or telecommunication authority, we'll stick with the status quo +since the community prefers to bias towards stability and avoid flip-flopping +between formats over time. If the silent majority becomes vocal to support +new formatting with authoritative evidence, then we'll collaborate with +community stakeholders on a transition. + +An example of this is the shift from using parentheses to hyphens to separate +area codes within North America. Hyphens may indicate that the area code is +optional in local circumstances, but this is shifting to become mandatory +in areas that have had more area code splits. However, the usage of +parentheses persists and both methods are acceptable. + +See [issue #1996](https://github.com/googlei18n/libphonenumber/issues/1996) +for some additional discussion. + ### Why does formatNumberForMobileDialing return an empty string for my number? If we don't think we can guarantee that the number is diallable from the user's