Add draft

Author: pwizla

docusaurus/docs/cms/configurations/features.md

@@ -45,6 +45,7 @@ To enable a future flag:
   module.exports = ({ env }) => ({
     future: {
       experimental_firstPublishedAt: env.bool('STRAPI_FUTURE_EXPERIMENTAL_FIRST_PUBLISHED_AT', false),
+      unstableAILocalizations: env.bool('STRAPI_UNSTABLE_AI_LOCALIZATIONS', false),
     },
   })
 
@@ -54,9 +55,10 @@ To enable a future flag:
 
   ```json title=".env"
   STRAPI_FUTURE_EXPERIMENTAL_FIRST_PUBLISHED_AT=true
+  STRAPI_UNSTABLE_AI_LOCALIZATIONS=true
   ```
 
-  If your environment file does not include this value, the `experimental_firstPublishedAt` future flag property value will default to `false` and the experimental feature will not be enabled.
+  If your environment file does not include this value, the `unstableAILocalizations` future flag property value will default to `false` and the experimental feature will not be enabled.
 
   </TabItem>
 
@@ -66,6 +68,7 @@ To enable a future flag:
   export default {
     future: {
       experimental_firstPublishedAt: env.bool('STRAPI_FUTURE_EXPERIMENTAL_FIRST_PUBLISHED_AT', false),
+      unstableAILocalizations: env.bool('STRAPI_UNSTABLE_AI_LOCALIZATIONS', false),
     },
   };
   ```
@@ -74,9 +77,10 @@ To enable a future flag:
 
   ```json title=".env"
   STRAPI_FUTURE_EXPERIMENTAL_FIRST_PUBLISHED_AT=true
+  STRAPI_UNSTABLE_AI_LOCALIZATIONS=true
   ```
 
-  If your environment file does not include this value, the `experimental_firstPublishedAt` future flag property value will default to `false` and the experimental feature will not be enabled.
+  If your environment file does not include this value, the `unstableAILocalizations` future flag property value will default to `false` and the experimental feature will not be enabled.
 
   </TabItem>
   </Tabs>
@@ -112,3 +116,4 @@ Developers can use the following APIs to interact with future flags:
 | Property name | Related feature | Suggested environment variable name |
 | ------------- | --------------- | ---------------------------------- |
 | `experimental_firstPublishedAt` | [Draft & Publish](/cms/features/draft-and-publish#recording-the-first-publication-date) | `STRAPI_FUTURE_EXPERIMENTAL_FIRST_PUBLISHED_AT` |
+| `unstableAILocalizations` | [AI-powered Internationalization](/cms/features/internationalization#ai-powered-internationalization) |

docusaurus/docs/cms/features/internationalization.md

@@ -11,6 +11,8 @@ tags:
 - features
 ---
 
+import StrapiAiCredits from '/docs/snippets/strapi-ai-credits.md'
+
 # Internationalization (i18n)
 
 <Tldr>
@@ -83,6 +85,18 @@ It is not possible to create custom locales. Locales can only be created based o
   }}
 />
 
+#### Enabling AI-powered internationalization
+<GrowthBadge /> <FeatureFlagBadge feature="unstableAILocalizations" />
+
+AI-Powered Internationalization enables automatic translations for all the locales in a project when the source content is updated. This enables content editors to have their content translated into multiple languages within a few seconds.
+
+AI-powered Internationalization is disabled by default. To enable it:
+
+1. Ensure the `unstableAILocalizations` [feature flag](/cms/configurations/features) is set to `true`. If you've just changed this configuration property, you might need to restart the Strapi server for the changes to apply.
+2. Go to <Icon name="gear-six" /> *Settings > Global Settings > Internationalization* and set _AI translations_ to on.
+
+<!-- TODO: add light/dark mode screenshots -->
+
 ### Code-based configuration
 
 A `STRAPI_PLUGIN_I18N_INIT_LOCALE_CODE` [environment variable](/cms/configurations/environment#strapi) can be configured to set the default locale for your environment. The value used for this variable should be an ISO country code from <ExternalLink to="https://github.com/strapi/strapi/blob/main/packages/plugins/i18n/server/src/constants/iso-locales.json" text="the 500+ pre-created list of locales"/>.
@@ -117,6 +131,17 @@ Click on the <Icon name="download-simple" /> *Fill in from another locale* butto
   }}
 />
 
+### AI-powered internationalization <NewBadge />
+<GrowthBadge /> <FeatureFlagBadge feature="unstableAILocalizations" />
+
+[When enabled](#enabling-ai-powered-internationalization), AI-powered internationalization enables automatic translations for all the locales in a project when the source content is updated. This enables content editors to have their content translated into multiple languages within a few seconds.
+
+Once enabled, whenever you edit a content-type in a given locale and click **Save**, all other locales for the content-type should be translated automatically, which will be confirmed by an _All locales have been translated_ notification. Using this feature consumes Strapi AI credits.
+
+<!-- TODO: add screenshot -->
+
+<StrapiAiCredits />
+
 ### Usage with APIs
 
 Localized content can be requested, created, updated, and deleted for a given locale through the various front-end APIs accessible from [Strapi's Content API](/cms/api/content-api):

docusaurus/sidebars.js

@@ -85,6 +85,9 @@ const sidebars = {
           type: 'doc',
           label: 'Internationalization (i18n)',
           id: 'cms/features/internationalization',
+          customProps: {
+            updated: true,
+          },
         },
         {
           type: 'doc',