Refactor localization guide to separate instructions for authentication and recovery endpoints, enhancing clarity on adding and removing locales

Author: brionmario

en/identity-server/next/docs/guides/branding/localization.md

@@ -167,22 +167,21 @@ To hide a language from the language switcher while keeping it available in othe
 
 {% raw %}
 
-### Authentication & Recovery endpoints {#add-remove-locales-in-authentication-recovery-endpoints}
+### Authentication endpoints {#add-remove-locales-in-authentication-endpoints}
 
 {% endraw %}
 
-The authentication and recovery endpoints use traditional properties files for localization.
+Configure localization for authentication endpoints using traditional properties files.
 
-#### Add a locale to endpoints
+#### Add a locale to authentication endpoints
 
-Follow these steps to add a new language to your authentication and recovery endpoints:
+Follow these steps to add a new language to your authentication endpoints:
 
 ##### Step 1: Create locale-specific resource files
 
-1. Navigate to the following directories based on the endpoint you want to configure:
+1. Navigate to the authentication endpoint directory:
 
     - **Authentication endpoint**: `<IS_HOME>/repository/deployment/server/webapps/authenticationendpoint/WEB-INF/classes/org/wso2/carbon/identity/application/authentication/endpoint/i18n/`
-    - **Recovery endpoint**: `<IS_HOME>/repository/deployment/server/webapps/accountrecoveryendpoint/WEB-INF/classes/org/wso2/carbon/identity/mgt/recovery/endpoint/i18n/`
 
 2. Duplicate the `Resources.properties` file in the same location.
 
@@ -232,16 +231,92 @@ Follow these steps to add a new language to your authentication and recovery end
 
 4. You should see the login screen displaying content in the configured language.
 
-#### Remove a locale from endpoints
+#### Remove a locale from authentication endpoints
 
-To remove a language from your endpoints:
+To remove a language from your authentication endpoints:
 
-1. Delete the corresponding `Resources_<locale>.properties` files from both authentication and recovery endpoint directories.
+1. Delete the corresponding `Resources_<locale>.properties` files from the authentication endpoint directory.
 
 2. Remove the language entry from the `LanguageOptions.properties` file.
 
 3. Restart the server for changes to take effect.
 
+{% raw %}
+
+### Recovery endpoints {#add-remove-locales-in-recovery-endpoints}
+
+{% endraw %}
+
+Configure localization for recovery endpoints using traditional properties files.
+
+#### Add a locale to recovery endpoints
+
+Follow these steps to add a new language to your recovery endpoints:
+
+##### Step 1: Create resource files for recovery endpoints
+
+1. Navigate to the recovery endpoint directory:
+
+    - **Recovery endpoint**: `<IS_HOME>/repository/deployment/server/webapps/accountrecoveryendpoint/WEB-INF/classes/org/wso2/carbon/identity/mgt/recovery/endpoint/i18n/`
+
+2. Duplicate the `Resources.properties` file in the same location.
+
+3. Rename the duplicated file with the required locale suffix:
+    - For British English: `Resources_en_GB.properties`
+    - For French (Standard): `Resources_fr.properties`
+
+    !!! note
+
+        Refer to [Web browser language identification codes](https://www.localeplanet.com/icu/){target="_blank"} for more information on locale suffixes.
+
+4. Update the values for each key in the new file:
+
+    ```properties
+    login=<Value in the required locale>
+    ```
+
+5. Save the file.
+
+##### Step 2: Configure language options for recovery endpoints
+
+1. Navigate to `<IS_HOME>/repository/deployment/server/webapps/authenticationendpoint/WEB-INF/classes/`.
+
+2. Open the `LanguageOptions.properties` file.
+
+3. Add information about the new language in the following format:
+
+    ```properties
+    <language switcher name>=<language code>,<language name>,<text direction>
+    ```
+
+    !!! note
+
+        The `<text direction>` parameter is optional. The default text direction is "ltr" (Left-to-Right).
+
+4. Save the file.
+
+##### Step 3: Test the recovery endpoint configuration
+
+1. Go to your browser settings and add the language you configured above to your preferred languages list.
+
+2. Restart the WSO2 Identity Server.
+
+3. Open a browser and navigate to the account recovery URL.
+
+   - For localhost: [https://localhost:9443/accountrecovery/](https://localhost:9443/accountrecovery/)
+
+4. You should see the recovery screens displaying content in the configured language.
+
+#### Remove a locale from recovery endpoints
+
+To remove a language from your recovery endpoints:
+
+1. Delete the corresponding `Resources_<locale>.properties` files from the recovery endpoint directory.
+
+2. Remove the language entry from the `LanguageOptions.properties` file (shared with authentication endpoints).
+
+3. Restart the server for changes to take effect.
+
 ## Configure Text Direction (RTL & LTR)
 
 WSO2 Identity Server supports both Right-to-Left (RTL) and Left-to-Right (LTR) text directions. **LTR is the default text direction** for most languages and doesn't require explicit configuration. RTL languages like Arabic, Hebrew, and Persian automatically adjust the interface layout and content flow when configured properly.
@@ -372,11 +447,11 @@ To configure text direction for languages in Console:
 
 {% raw %}
 
-### Authentication & Recovery endpoints {#configure-text-direction-in-authentication-recovery-endpoints}
+### Authentication endpoints {#configure-text-direction-in-authentication-endpoints}
 
 {% endraw %}
 
-To configure text direction for authentication and recovery endpoints:
+To configure text direction for authentication endpoints:
 
 1. Navigate to `<IS_HOME>/repository/deployment/server/webapps/authenticationendpoint/WEB-INF/classes/`.
 
@@ -404,6 +479,40 @@ To configure text direction for authentication and recovery endpoints:
 
 4. Save the file and restart the server for changes to take effect.
 
+{% raw %}
+
+### Recovery endpoints {#configure-text-direction-in-recovery-endpoints}
+
+{% endraw %}
+
+To configure text direction for recovery endpoints:
+
+1. Navigate to `<IS_HOME>/repository/deployment/server/webapps/authenticationendpoint/WEB-INF/classes/`.
+
+2. Open the `LanguageOptions.properties` file (shared with authentication endpoints).
+
+3. Configure the language entry based on text direction:
+
+    **For LTR languages (default):**
+
+    ```properties
+    lang.switch.en_US=en,English,ltr
+    ```
+    
+    or simply (LTR is assumed if not specified):
+
+    ```properties
+    lang.switch.en_US=en,English
+    ```
+
+    **For RTL languages:**
+
+    ```properties
+    lang.switch.ar_AE=ar,Arabic - العربية,rtl
+    ```
+
+4. Save the file and restart the server for changes to take effect.
+
 !!! tip
 
-    The RTL/LTR configuration for authentication and recovery endpoints applies to both applications when you update the `LanguageOptions.properties` file in the authentication endpoint directory.
+    The RTL/LTR configuration applies to both authentication and recovery endpoints since they share the same `LanguageOptions.properties` file.