Update flow docs.

.vale/styles/Microsoft/Wordiness.yml

@@ -57,8 +57,6 @@ swap:
   despite the fact that: although
   disappear from sight: disappear
   doomed to fail: doomed
-  drag and drop: drag
-  drag-and-drop: drag
   due to the fact that: because
   during the period of: during
   during the time that: while

en/identity-server/next/docs/guides/flows/troubleshooting.md

@@ -0,0 +1 @@
+{% include "../../../../../includes/guides/flows/troubleshooting.md" %}

en/identity-server/next/docs/guides/organization-management/inheritance-in-organizations/flow-inheritance.md

@@ -0,0 +1 @@
+{% include "../../../../../../includes/guides/organization-management/inheritance-in-organizations/flow-inheritance.md" %}

en/identity-server/next/mkdocs.yml

@@ -712,6 +712,7 @@ nav:
         - Self Registration: guides/flows/self-registration.md
         - Password Recovery: guides/flows/password-recovery.md
         - Invited User Registration: guides/flows/invited-user-registration.md
+        - Troubleshooting: guides/flows/troubleshooting.md
       - User self-service:
         - User self-service: guides/user-self-service/index.md
         - My Account portal:
@@ -755,6 +756,7 @@ nav:
             - Email and SMS templates inheritance: guides/organization-management/inheritance-in-organizations/email-sms-templates-inheritance.md
             - User attributes inheritance: guides/organization-management/inheritance-in-organizations/attribute-inheritance.md
             - OIDC scope inheritance: guides/organization-management/inheritance-in-organizations/oidc-scope-inheritance.md
+            - Flow inheritance: guides/organization-management/inheritance-in-organizations/flow-inheritance.md
           - Organization discovery:
             - Organization discovery: guides/organization-management/organization-discovery/index.md
             - Email domain based organization discovery: guides/organization-management/organization-discovery/email-domain-based-organization-discovery.md

en/includes/guides/flows/build-a-flow.md

@@ -1,90 +1,89 @@
 # Get started with flows
 
-A **flow** defines the sequence of steps a user goes through during a specific interaction with your application. This guide introduces the **Flow Builder**, a visual environment with all the necessary elements to build flows that meet both security requirements and user experience goals.
+A **flow** defines the step by step journey a user takes during a specific interaction with your application, like signing up or resetting a password. This guide introduces the **Flow Builder**, a visual canvas where you can design and customize these journeys to meet your security and user experience goals without writing complex code.
 
-Using the flow builder in {{product_name}} you can fully customize the following flows. Click on a flow to view a sample scenario built using the flow builder.
+The Flow Builder allows full customization of the following user journeys. Click on a flow to view a sample scenario built using the flow builder.
 
-- [Self-registration]({{base_path}}/guides/flows/self-registration/)
+- [Self registration]({{base_path}}/guides/flows/self-registration/)
 - [Password recovery]({{base_path}}/guides/flows/password-recovery/)
 - [Invited user registration]({{base_path}}/guides/flows/invited-user-registration/)
 
-## Access the flow builder
+## Create and enable a flow
 
-You can access the flow builder by following the steps below:
+The following sections outline the process for creating and publishing a custom flow.
 
-1. On the {{product_name}} Console, go to **Flows**.
+### Step 1: Access the flow builder
 
-2. Click on the card corresponding to the flow you want to build.
+To access the flow builder:
 
-3. [Build the flow](#build-a-flow) and [enable](#enable-a-flow) it.
+1. On the {{product_name}} Console, go to **Flows**.
 
-## Build a flow
+2. Click on the corresponding flow you want to build. This opens the Flow Builder canvas for that specific flow.
 
-The **Flow builder** provides all the building blocks you need to create user journeys.
+### Step 2: Build the flow
 
-For a selected flow, you can start building it using one of the methods below and use [flow elements](#reference-flow-elements) to customize it to your requirements.
+The **Flow builder** provides all the building blocks you need to create user journeys. To start building, you can choose one of the following methods and use [flow elements](#flow-elements) to customize it.
 
 {% if product_name == "Asgardeo" %}
 
-### Generate with AI
+- **Generate with AI**
 
-With **Generate with AI**, you can use plain language instructions to build a complete flow, allowing you to start with a minimal effort and customize components as needed.
+    Describe your flow in plain language, and let the generative AI engine automatically build it for you. You can then customize and refine the components as needed.
 
-![Flow builder AI]({{base_path}}/assets/img/guides/flows/flow-builder-generate-with-ai.png){: width="auto" style="display: block; margin: 0;"}
+    ![Flow builder AI]({{base_path}}/assets/img/guides/flows/flow-builder-generate-with-ai.png){: width="auto" style="display: block; margin: 0;"}
 
 {% endif %}
 
-### Use a starter template
+- **Use a starter template**
 
-Starter templates offer commonly used starting points, so you don’t have to begin from scratch. Click the `+` button next to a template to add it to the flow.
+    Select from a list of pre-built templates for common use cases to avoid starting from scratch. Click the `+` icon next to a template to add it to the canvas.
 
-![Starter Templates]({{base_path}}/assets/img/guides/flows/flow-builder-starter-templates.png){: width="auto" style="display: block; margin: 0;"}
+    ![Starter Templates]({{base_path}}/assets/img/guides/flows/flow-password-recovery-start-from-template.png){: width="auto" style="display: block; margin: 0;"}
 
-### Build from scratch
+- **Build from scratch**
 
-If you prefer to take complete control of the building process, you can start with a blank canvas and add steps, widgets, and components to build your flow.
+    For complete control, start with a blank canvas and build the flow by dragging and dropping the required [flow elements](#flow-elements).
 
-![Custom Flow]({{base_path}}/assets/img/guides/flows/flow-builder-custom-flow.png){: width="auto" style="display: block; margin: 0;"}
+    ![Build flow manually]({{base_path}}/assets/img/guides/flows/flow-builder-build-flow-manually.png){: width="auto" style="display: block; margin: 0;"}
 
-## Enable a flow
+### Step 3: Enable the flow
 
-{{product_name}} provides default sequences for every flow in the flow builder. You can design and refine your customized flow at your own pace, keeping it disabled until you’re ready to share it. While your customized flow is disabled, users continue to experience the default flow. Once enabled, your users will seamlessly change to the customized experience you’ve created.
+You can enable a flow using the toggle on the top right corner of the Flow Builder. Your flows behave as follows based on their state:
 
-To enable a flow,
+- If disabled,
 
-1. On the {{product_name}} Console, go to **Flows**.
+    - You can build your flow and save it as a draft. The flow won't be active for users until you enable it.
+    - This is the default state for any new flow.
 
-2. Select the flow you want to enable.
+- If enabled,
 
-3. On the top-right corner of the screen, turn the toggle ON to enable the flow.
+    - The flow becomes immediately available for users.
+    - You can continue to make changes and improvements to the flow even after enabling it. Until you publish those changes, users will continue to experience the last published version.
+    - You can disable the flow at any time to remove it from user access temporarily.
 
-!!! Note
+## Flow elements
+
+The Flow Builder provides a library of reusable, no-code elements to create user journeys. The following sections describe the key flow elements.
 
-    If you disable a customized flow, your users will automatically continue with the default experience until you’re ready to publish it again.
+### Steps
 
-## Reference: Flow elements
+Steps function as the core building block and represent a distinct part of the login process. A flow can contain one or more steps.
 
-Flow elements work together to create the user journey. They define the structure, functionality, and appearance of each step in the flow.
+![Steps]({{base_path}}/assets/img/guides/flows/flow-builder-steps.gif){: width="auto" style="display: block; margin: 0;"}
 
 ### Widgets
 
-Widgets are reusable components that enhance the flow. Drag and drop widgets into your desired view to build a flow.
+Pre-built login and identity verification components that you can drag and drop into a step.
 
 ![Widgets]({{base_path}}/assets/img/guides/flows/flow-builder-widgets.gif){: width="auto" style="display: block; margin: 0;"}
 
-### Steps
-
-Steps are the core building blocks of a flow. Drag and drop steps to create a multi‑step user journey.
-
-![Steps]({{base_path}}/assets/img/guides/flows/flow-builder-steps.gif){: width="auto" style="display: block; margin: 0;"}
-
 ### Components
 
-Components are atomic UI elements that you can add to a step. Drag and drop components inside a step.
+Components are the individual UI elements placed inside a step, such as input fields, buttons, and paragraphs.
 
 !!! Note
 
-    Field components such as **Text Input** and **Email Input** etc. have the following contraints:
+    Field components such as **Text Input** and **Email Input** etc. have the following constraints:
 
        - Only a **Form** component can contain them.
 
@@ -94,4 +93,4 @@
 
          - From the **Attribute** dropdown, select the relevant attribute. Only attributes **displayed in user profiles** are available for mapping. Learn how to [display attributes in user profiles]({{base_path}}/guides/users/attributes/manage-attributes/#configure-attributes).
 
-![Components]({{base_path}}/assets/img/guides/flows/flow-builder-components.gif){: width="auto" style="display: block; margin: 0;"}
+![Components]({{base_path}}/assets/img/guides/flows/flow-builder-components.gif){: width="auto" style="display: block; margin: 0;"}

en/includes/guides/flows/index.md

@@ -1,17 +1,20 @@
 # Flows
 
-A flow defines the sequence a user follows during a specific interaction with your application. These can include forms, verification actions, conditional logic, and other components that guide users from start to finish.
+Design and customize key user journeys in your application with Flows. A flow defines the step-by-step journey a user takes during a specific interaction, such as registering for your service or recovering a password.
 
-{{product_name}} lets you build fully customizable sequences for the following user interactions.
+{{product_name}} lets you build fully customizable flows for the following user interactions.
 
-- **Self-registration** - Create registration experiences for new users, with support for multi step forms, validations, and identity verification.
+- **Self registration** - Create seamless registration experiences for new users, with support for multi-step forms, data validation, and identity verification checks.
 
-- **Password recovery** - Build secure recovery flows to help users regain access, using steps such as email verification or one time passwords (OTP).
+- **Password recovery** - Build secure recovery processes to help users regain access, using steps such as email verification or one-time passwords (OTP).
 
-- **Invited user registration** - Build flow that allows new users to securely set their password when an administrator creates their account, including steps to verify the user's identity.
+- **Invited user registration** - Let new users complete creating their accounts when administrators invite them. Design secure flows to verify their identities and set their passwords.
 
-You can build flows using starter templates, widgets, steps, and components, giving you complete control over how users interact with your application. To get started with building flows, refer to [Build a flow]({{base_path}}/guides/flows/build-a-flow/).
+Building with starter templates, widgets, and other components provides complete control over how users interact with the application, all without writing complex code.
 
-For specific examples of building flows, refer to [Self-registration]({{base_path}}/guides/flows/self-registration/), [Password recovery]({{base_path}}/guides/flows/password-recovery/) and [Invited user registration]({{base_path}}/guides/flows/invited-user-registration/).
+## Start building flows
 
-![Flows]({{base_path}}/assets/img/guides/flows/flow-builder-steps.gif){: width="auto" style="display: block; margin: 0;"}
+- To learn the fundamentals of building a flow, refer to the [get started]({{base_path}}/guides/flows/build-a-flow/) guide.
+- For detailed examples of specific use cases, see the guides on [Self registration]({{base_path}}/guides/flows/self-registration/), [Password recovery]({{base_path}}/guides/flows/password-recovery/) and [Invited user registration]({{base_path}}/guides/flows/invited-user-registration/).
+
+![Flows]({{base_path}}/assets/img/guides/flows/Flow-builder-overview.png){: width="auto" style="display: block; margin: 0;"}