docs: translation module (#14271)

* docs: translation module * fix link in JS SDK * add translations user guides [WIP] * updates * fix broken link * remove mentions of default locale * change header * updates * updated user guides * handle todos * fix build error * fix lint errors
2025-12-17 13:07:43 +02:00
parent 1743ed7f04
commit c1a5390fc6
133 changed files with 21304 additions and 1661 deletions
@@ -0,0 +1,34 @@
+import { Prerequisites } from "docs-ui"
+
+export const metadata = {
+  title: `Store Locales`,
+}
+
+# {metadata.title}
+
+In this guide, you'll learn about locales defined in the Store Module.
+
+<Prerequisites
+  items={[
+    {
+      text: "Medusa v2.12.3 or later",
+      link: "https://github.com/medusajs/medusa/releases/tag/v2.12.3",
+    },
+  ]}
+/>
+
+<Note>
+
+While the Store Module allows you to manage the locales for your store, the actual locale data and translations are managed by the [Translation Module](../../translation/page.mdx).
+
+</Note>
+
+## Supported Locales
+
+The Store Module has a [StoreLocale](/references/store/models/StoreLocale) data model that represents the locales supported by your store. It has a `locale_code` property that follows the [IETF BCP 47 standard](https://gist.github.com/typpo/b2b828a35e683b9bf8db91b5404f1bd1). For example, `en-US` represents American English, while `fr-FR` represents French (France).
+
+`StoreLocale` belongs to the [Store](/references/store/models/Store) data model, which has a `supported_locales` property that lists all the locales available in your store.
+
+For example, if your store supports English (United States) and French (France), you'll have two `StoreLocale` records with the locale codes `en-US` and `fr-FR`.
+
+![Diagram illustrating the relationship between the Store and StoreLocale data models](https://res.cloudinary.com/dza7lstvk/image/upload/v1765371144/Medusa%20Resources/store-locale_ckanv4.jpg)