diff --git a/categories.xml b/categories.xml
index b4f7f51..e17ec9e 100644
--- a/categories.xml
+++ b/categories.xml
@@ -1,4 +1,5 @@
+ This method can be called as many time as needed. All passed JSON objects are deeply merged internally.
+
+ An application that supports globalization and/or localization will need to have a way to determine the user's preference. Attempting to automatically determine the appropriate locale is useful, but it is good practice to always offer the user a choice, by whatever means.
+
+ Whatever your mechanism, it is likely that you will have to correlate the user's preferences with the list of locale data supported in the app. This method allows you to select the best match given the locale data that you have included and to set the Globalize locale to the one which the user prefers.
+
+ LanguageMatching TBD (CLDR's spec http://www.unicode.org/reports/tr35/#LanguageMatching).
+
+
{
+// attributes: {
+// "languageId": "pt",
+// "maxLanguageId": "pt_Latn_BR",
+// "language": "pt",
+// "script": "Latn",
+// "territory": "BR",
+// "region": "BR"
+// },
+// some more stuff...
+// }
+]]>
+
Globalize is a JavaScript library for internationalization and localization that leverages the official Unicode CLDR JSON data.
+ +To get started, use the search at the top of the page, view the + full listing of entries, or browse by + category from the sidebar.
\ No newline at end of file