docs/8.0/ayanova/docs/ay-start-localization.md

@@ -0,0 +1,49 @@
+# LOCALIZATION OVERRIDE
+
+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.
+
+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.  
+
+If necessary, these override settings will replace the browser provided defaults for use in AyaNova.
+
+
+## Language code override
+
+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. 
+
+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.
+
+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.
+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`.
+
+
+
+
+
+
+todo: list of common language codes here to save lookup
+todo: alternative to forcing overrides by setting browser defaults instead in browser
+
+
+
+