Merge pull request #5602 from HasiniSama/root-display-name

Update outdated manage root organization UI in IS next docs and add manage current organization section

Author: himeshsiriwardana

en/identity-server/next/docs/assets/img/guides/multitenancy/create-root-organization-modal.png

@@ -49,8 +49,12 @@ Follow the steps given below to add a new root organization from the {{ product_
       </thead>
       <tbody>
         <tr>
-          <td><code>Domain</code></td>
-          <td>The domain name (e.g., abc.com) is used as a unique identifier for your organization. The URL for the new root organization's Console will be `https://<IS_HOST>:<PORT>/t/<DOMAIN>/console` URL.</td>
+          <td><code>Organization Name</code></td>
+          <td>Enter a user friendly name (for example, ABC Builders) for your organization. Your organization will use this name for branding purposes in notification templates.</td>
+        </tr>
+        <tr>
+          <td><code>Organization Handle (Domain)</code></td>
+          <td>Enter an organization handle (tenant domain) (for example, abc) to uniquely identify your organization. Access the new root organization's Console at `https://<IS_HOST>:<PORT>/t/<DOMAIN>/console`.</td>
         </tr>
         <tr>
           <td><code>First Name</code></td>
@@ -70,11 +74,14 @@ Follow the steps given below to add a new root organization from the {{ product_
         </tr>
         <tr>
           <td><code>Password</code></td>
-          <td>The password used when singing in with the username specified above.</td>
+          <td>The password used when signing in with the username specified above.</td>
         </tr>
       </tbody>
     </table>
 
+    !!! note
+        Keep the **Organization Name** field blank to use the **Organization Handle** (tenant domain) as the name.
+
 5. Once a new root organization is created, it will be listed in the the **Root Organization** listing page as shown below.
 
     ![Root Organization Listing]({{base_path}}/assets/img/guides/multitenancy/root-organizaiton-listing.png)

en/identity-server/next/docs/assets/img/guides/multitenancy/root-organization-details.png

@@ -121,13 +121,20 @@ Listed below are general branding preferences you can apply to the interfaces.
    <tr>
       <td><b>Organization Display Name</b></td>
       <td>This name will appear as the organization name in the emails that send to your users. If not set, {{ product_name }} defaults are used.</td>
-   </tr>   
+   </tr>
     <tr>
       <td><b>Contact Email</b></td>
       <td>This email address will appear on emails, error pages and, other pages where users would require support from the organization admin.</td>
    </tr>
 </table>
 
+{% if product_name == "WSO2 Identity Server" and is_version > "7.1.0" %}
+!!! warning "Deprecated feature"
+    The branding **Organization Display Name** feature has been deperecated. Use the root organization name instead to ensure consistency and better customization.
+
+    See [Manage current organization]({{base_path}}/guides/organization-management/manage-organizations/#manage-current-organization) for more information.
+{% endif %}
+
 ### Design preferences
 
 Listed below are the design changes you can apply to the user registration interface, login interfaces and My Account portal.

en/identity-server/next/docs/assets/img/guides/multitenancy/root-organizations-dropdown.png

@@ -75,6 +75,28 @@ You can switch to a child organization on the {{ product_name }} Console by sele
 
 ![organizations]({{base_path}}/assets/img/guides/organization/manage-organizations/organization-switch.png){: width="700" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
 
+{% if product_name == "WSO2 Identity Server" and is_version > "7.1.0" %}
+
+## Manage current organization
+
+You can view and edit details of the organization you are currently logged in to:
+
+1. On the {{ product_name }} Console, click the organization name in the breadcrumb navigation.
+
+2. On the dropdown that appears, click **Edit Organization**.
+
+    ![Manage current organization]({{base_path}}/assets/img/guides/organization/manage-organizations/edit-current-organization-dropdown-option.png){: width="500" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
+
+3. Update the organization name and click **Save**.
+
+    ![Manage current organization]({{base_path}}/assets/img/guides/organization/manage-organizations/edit-current-organization.png){: width="500" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
+
+!!! note
+    - The **Edit/View Organization** options appear only if you have organization administrator privileges.
+    - Currently, you can edit only the organization name.
+
+{% endif %}
+
 ## Build an organizational hierarchy
 
 Organizations can be structured hierarchically in {{product_name}}. This means that if you are a parent organization, you may have multiple child organizations and each child organization can have their own child organizations and so on. This enables you to easily reflect the real-world structure of your business in {{product_name}}.