docs: Project Settings > Languages

src/content/docs/crowdin/project-management/project-settings/languages.mdx

@@ -5,9 +5,8 @@ sidebar:
   order: 2
 ---
 
-import {Aside, Steps} from '@astrojs/starlight/components';
+import { Aside, Steps, LinkCard } from '@astrojs/starlight/components';
 import { Image } from 'astro:assets';
-import sourceLanguage from '!/crowdin/project-management/settings/source_language.png';
 import targetLanguagesUpdating from '!/crowdin/project-management/settings/target_languages_updating.png';
 import targetLanguagesCopying from '!/crowdin/project-management/settings/target_languages_copying.png';
 import customLanguageAdding from '!/crowdin/project-management/settings/custom_language_adding.png';
@@ -18,9 +17,7 @@ In the Languages section, you can manage your project source and target language
 
 ## Source Language
 
-If you want to change the source language for your project, select a new language from the drop-down list and click **Update**.
-
-<Image src={sourceLanguage} alt="Source Language" />
+The source language is the language you're translating from. If you want to change the source language for your project, select a new language from the drop-down list and click **Update**.
 
 Here are a few points you should be aware of when changing the project’s source language:
 
@@ -93,4 +90,8 @@ To add language mapping, follow these steps:
 
 ## See Also
 
-- [Supported Languages](https://developer.crowdin.com/language-codes/)
+<LinkCard
+  title="Supported Languages"
+  href="https://developer.crowdin.com/language-codes/"
+  target="_blank"
+/>

src/content/docs/enterprise/project-management/project-settings/general.mdx

@@ -7,9 +7,9 @@ sidebar:
 
 import { Image } from 'astro:assets';
 import { Aside } from '@astrojs/starlight/components';
-import details from '!/enterprise/project-management/settings/project_settings_details.png';
-import ownership from '!/enterprise/project-management/settings/project_settings_ownership.png';
-import projectRemoval from '!/enterprise/project-management/settings/project_settings_project_removal.png';
+import details from '!/enterprise/project-management/settings/project_details.png';
+import ownership from '!/enterprise/project-management/settings/project_ownership.png';
+import projectRemoval from '!/enterprise/project-management/settings/project_removal.png';
 
 You can configure project settings according to your needs in the **Settings** tab.
 

src/content/docs/enterprise/project-management/project-settings/languages.mdx

@@ -5,12 +5,55 @@ sidebar:
   order: 2
 ---
 
-Similar to https://support.crowdin.com/changing-target-languages/, https://support.crowdin.com/enterprise/project-settings/#languages
+import { Steps, LinkCard } from '@astrojs/starlight/components';
+import { Image } from 'astro:assets';
+import { Icon } from 'astro-icon/components';
+import targetLanguages from '!/enterprise/project-management/settings/target_languages.png';
+import languageMapping from '!/enterprise/project-management/settings/language_mapping.png';
+
+In the **Languages** section, you can manage your project source and target languages and configure language mapping to use custom language codes.
 
 ## Source Language
 
+The source language is the language you're translating from. If you want to change the source language for your project, select a new language from the drop-down list and click **Save**.
+
+Here are a few points you should be aware of when changing the project’s source language:
+
+* Please note that there might be a plural form mismatch for imported strings depending on the new source language. For example, some plural forms might not be displayed in the Editor, or some plural form translations might be used in other ones on translation export. We recommend updating the source files if the new source language has different plural forms than the initial one.
+* If you had an opened browser tab with the Editor during the source language update, you might need to refresh it for changes to take effect and continue translating from the new source language.
+
 ## Target Languages
 
-### Adding Custom Languages
+The **Target Languages** section allows you to add or remove target languages in your project.
+
+You can update your target languages anytime. To add or remove target languages in your project, follow these steps:
+
+<Steps>
+  1. Open your project and go to **Settings > Languages**.
+  2. In the **Target Languages** section, you can make the following changes:
+      * Select the languages you want to add to the project in the left panel.
+      * Click <Icon name="mdi:close-circle" class="inline-icon" /> on the languages you want to remove from the project in the right panel.
+  3. Click **Update**.
+</Steps>
+
+<Image src={targetLanguages} alt="Target Languages" />
+
+## Language Mapping
+
+Add custom language codes and use them for translation files export. This will keep the structure of exported files consistent.
+
+For example, in the screenshot below two custom codes are set for French and German languages. If any of custom placeholders (3 letters codes) is used during [file export](/enterprise/file-management#file-export) the file name will include these specific language codes (fra, ger).
+
+<Image src={languageMapping} alt="Language Mapping" />
+
+## Adding Custom Languages
+
+Custom languages are managed at the Organization level. See the [Organization Settings](/enterprise/organization-settings/) section for more information.
+
+## See Also
 
-### Adding Custom Language Codes
+<LinkCard
+  title="Supported Languages"
+  href="https://developer.crowdin.com/language-codes/"
+  target="_blank"
+/>

src/content/docs/enterprise/project-management/sources/file-management.mdx

@@ -50,7 +50,7 @@ Define a file name or full path in the resulting archive, use the available plac
 
 For example, you want the source file `Overview.csv` with Ukrainian translation to be named `Overview.ukrainian.csv` before integrating it with the application. In this case, you'd need to set the *Resulting file after translations export* to the following: `Overview.%language%.csv`.
 
-By default, Crowdin Enterprise adds [Crowdin language codes](https://developer.crowdin.com/language-codes/) during the file export. To use custom ones for specific languages in the whole project, set up [Language Mapping](/enterprise/project-settings/languages#adding-custom-language-codes).
+By default, Crowdin Enterprise adds [Crowdin language codes](https://developer.crowdin.com/language-codes/) during the file export. To use custom ones for specific languages in the whole project, set up [Language Mapping](/enterprise/project-settings/languages#language-mapping).
 
 <Image src={filesSettings} alt="File Settings" width="600" />