diff --git a/docs/8.0/ayanova/docs/ay-start-localization.md b/docs/8.0/ayanova/docs/ay-start-localization.md index 1034f717..32aa46f8 100644 --- a/docs/8.0/ayanova/docs/ay-start-localization.md +++ b/docs/8.0/ayanova/docs/ay-start-localization.md @@ -1,52 +1,49 @@ # LOCALIZATION OVERRIDES Localization here means the way in which times, dates and numbers are displayed and interpreted by AyaNova. -It does *not* have any connection to the [Translation](ay-translation.md) features of AyaNova which determine what text is displayed in the user interface. +It is separate and distinct from the [Translation](ay-translation.md) feature of AyaNova which is used to set the text displayed in the user interface. -AyaNova relies on the web browser to provide the language and time zone to be used automatically. These settings in turn determine how time, date, currency and numbers are displayed and interpreted when typed in. +AyaNova relies on the web browser to provide the language and time zone to be used automatically. These settings in turn determine how time, date, currency and numbers are displayed and interpreted when typed in. -Rarely if ever should there be a need to override the browser's defaults as they generally come from the operating system itself and should be most appropriate for the user and device already. +Rarely if ever should there be a need to override the browser's defaults as they generally come from the operating system itself and should be most appropriate for the user and device already. If necessary, these override settings will replace the browser provided defaults for use in AyaNova. ## When to override -Ideally the browser should already have the correct settings for the user based on their device or operating system already. If a change is required it's best to try to set it inside the browser itself first using the Browser's own settings and only rely on these settings below in AyaNova as a last resort. +Ideally you should never have to override language or time zone; the browser should automatically provide the correct settings for the user based on their device and operating system. If a change is required it's best to try to set it inside the browser itself using the Browser's own settings first before using the settings below in AyaNova as a last resort. ## Language code override -The Language Code controls how the browser displays and accepts Numbers, Date and time values. +The Language Code controls how the browser displays and accepts Numbers, Date and time values. -The *default* value for this setting is obtained from the browser's language setting. If more than one language is set for the browser the *first* language is used. +The _default_ value for this setting is obtained from the browser's language setting. If more than one language is set for the browser the _first_ language is used. When no override setting has been made by the user this form displays the currently in-use default value in light gray text below this field. -This setting is provided for the purpose of forcing a browser to use a different one of it's installed languages than the default. Unless you have a specific reason, it's best to leave this field empty and accept the browsers default language or make adjustments in the browser's language settings rather than here. +This setting is provided for the purpose of forcing a browser to use a different one of it's installed languages than the default. Unless you have a specific reason, it's best to leave this field empty and accept the browsers default language or make adjustments in the browser's language settings rather than here. If no language can be determined from the browser and no override has been set AyaNova will default to English USA - "en-US". NOTE: This is a separate and unrelated setting to the users [Translation](ay-translation.md) setting which controls the set of customizable text used by AyaNova to display to the user. ### Choosing a Language code + To get started choosing a language code (a.k.a "Language Tag") here is a helpful guide from the standards body: [W3.org](https://www.w3.org/International/questions/qa-choosing-language-tags) - ## Time Zone override -The *required* Time Zone setting controls how date and time values are displayed, accepted for input and very importantly **converted** to local time from UTC time. + +The _required_ Time Zone setting controls how date and time values are displayed, accepted for input and very importantly **converted** to local time from UTC time. Wikipedia has a helpful list of time zone database codes [https://wikipedia.org/wiki/List_of_tz_database_time_zones](https://wikipedia.org/wiki/List_of_tz_database_time_zones) This value must be the "database name" value, for example: `America/Denver` or `Australia/Sydney`. If no value can be determined from the browser, and no override has been set, the default Time Zone used is `America/New_York`. -## Currency code (required not an override) -Browsers do not have a default currency code (at time of writing) so this is one setting that *must* be set by the user and included here for reference. +## Currency code (required, not an override) -The Currency Code controls how currency values are displayed and accepted for input in AyaNova. The code must be one of the 3 character alphabetic [ISO 4217 active currency codes](https://wikipedia.org/wiki/ISO_4217#Active_codes) This value is *required* and cannot be determined from the Browser itself. If no setting is made the *default* value is "USD" for dollar symbol $. +Browsers do not have a default currency code (at time of writing) so this is one setting that _must_ be set by the user and included here for reference. + +The Currency Code controls how currency values are displayed and accepted for input in AyaNova. The code must be one of the 3 character alphabetic [ISO 4217 active currency codes](https://wikipedia.org/wiki/ISO_4217#Active_codes) This value is _required_ and cannot be determined from the Browser itself. If no setting is made the _default_ value is "USD" for dollar symbol $. Some other common currency codes are: "EUR" - Euro, "GBP" - Great British Pound, "CAD" - Canadian dollar, "AUD" - Australian dollar. - - - - -