fix: various content related updated (#370)

Author: jor2

docs/about.md

@@ -7,7 +7,7 @@ This deployable architecture is **typically consumed as a dependency** by other
 You can choose from two variations when deploying:
 
 * **Resource groups only**: Creates a structured set of IBM Cloud resource groups to help organize cloud resources by function.
-* **Resource groups with Account Settings**: In addition to resource groups, configures account-level settings for access control, security, and compliance alignment.
+* **Resource groups with Account Settings**: In addition to resource groups, this deployment configures account-level settings for security, compliance, and session management.
 
 ---
 
@@ -16,7 +16,7 @@ You can choose from two variations when deploying:
 IBM Cloud uses Resource Groups to help organize and manage your cloud resources, similar to folders on your computer.
 For more details on resource groups, see the [IBM Cloud documentation](https://cloud.ibm.com/docs/account?topic=account-account_setup).
 
-It provisions an opinionated structure of labeled resource groups for clearer separation of responsibilities and improved access control.
+It provisions an opinionated structure of labeled resource groups for clearer separation of responsibilities and improved resource organization.
 
 | Category      | Default Resource Group Name | Suggested Use Case                                                          |
 | ------------- | --------------------------- | --------------------------------------------------------------------------- |
@@ -36,7 +36,7 @@ It provisions an opinionated structure of labeled resource groups for clearer se
 
 ---
 
-## Account Settings – Enhancing Security, Access Control, and Compliance
+## Account Settings – Enhancing Security, Session Management, and Compliance
 
 All account settings applied by this deployable architecture can be customized through input parameters in the deployable architecture interface (DA). This includes options for session timeout values, trusted profile names, and context-based restrictions (CBR) configuration.
 For more details on the folliung topics see the IBM Cloud documentation:

docs/account-settings-configuration.md

@@ -1,6 +1,6 @@
 # Account Settings Configuration
 
-This document provides detailed guidance on how to customize the IBM Cloud **Account Settings** when using **Cloud automation for Account Configuration**. These settings enhance security, access control, and compliance alignment across your IBM Cloud account.
+This document offers guidance on customizing the IBM Cloud Account Settings within the Cloud automation for Account Configuration. You will learn to configure these settings to enhance security, optimize session management and align compliance across your account.
 
 Account settings are applied when you choose the **Resource groups with Account Settings** variation.
 

docs/resource-group-configuration.md

@@ -2,7 +2,7 @@
 
 This **Deployable Architecture** is typically consumed as a dependency by other architectures. It provides a structured set of IBM Cloud resource‑group options to help you organise workloads and apply governance at scale.
 
-The deployable architecture supports multiple ways to define your resource‑group layout—from a single default group to a more opinionated structure for improved separation of duties and access control.
+This deployment architecture helps define resource group layouts in multiple ways—ranging from a single default group to a more structured, opinionated setup. These layout definitions support separation of duties by decoupling resource organization from role-based responsibilities.
 
 For more more details and best practices for organizing resources, see the [IBM Cloud documentation](https://cloud.ibm.com/docs/account?topic=account-account_setup).
 

ibm_catalog.json

@@ -22,7 +22,7 @@
         "iam"
       ],
       "short_description": "Creates and configures basic settings for an IBM Cloud account",
-      "long_description": "This deployable architecture creates and configures the foundational settings for an IBM Cloud account. This includes IAM account settings, a trusted profile and associated access groups, and the resource groups in which all resources are provisioned. [Learn more](https://github.com/terraform-ibm-modules/terraform-ibm-account-infrastructure-base/tree/main/docs/about.md).\n\n You can choose from two variations when deploying: \n  **Resource groups only**: Creates a structured set of IBM Cloud resource groups to help organize cloud resources by function. [Learn more](https://github.com/terraform-ibm-modules/terraform-ibm-account-infrastructure-base/tree/main/docs/resource-group-configuration.md).\n  **Resource groups with Account Settings**: In addition to resource groups, this variation configures account-level settings for access control, security, and compliance alignment. [Learn more](https://github.com/terraform-ibm-modules/terraform-ibm-account-infrastructure-base/tree/main/docs/account-settings-configuration.md).",
+      "long_description": "This deployable architecture creates and configures the foundational settings for an IBM Cloud account. This includes IAM account settings, a trusted profile and associated access groups, and the resource groups in which all resources are provisioned. [Learn more](https://github.com/terraform-ibm-modules/terraform-ibm-account-infrastructure-base/tree/main/docs/about.md).\n\nTo deploy this architecture you can choose one of the below variations:\n- **Resource groups only**: Creates a structured set of IBM Cloud resource groups to help organize cloud resources by function. [Learn more](https://github.com/terraform-ibm-modules/terraform-ibm-account-infrastructure-base/tree/main/docs/resource-group-configuration.md).\n- **Resource groups with Account Settings**: In addition to resource groups, this variation configures account-level settings for security, compliance, and session management. [Learn more](https://github.com/terraform-ibm-modules/terraform-ibm-account-infrastructure-base/tree/main/docs/account-settings-configuration.md).",
       "offering_docs_url": "https://github.com/terraform-ibm-modules/terraform-ibm-account-infrastructure-base/tree/main/docs/about.md",
       "offering_icon_url": "https://raw.githubusercontent.com/terraform-ibm-modules/documentation/main/icons/security_icon.svg",
       "provider_name": "IBM",
@@ -32,7 +32,7 @@
           "description": "Configures IAM account settings to meet compliance requirements for the IBM Cloud Framework for Financial Services."
         },
         {
-          "title": "Access controls",
+          "title": "Project access setup",
           "description": "Creates a trusted profile and associated access group to grant IBM Cloud projects access to securely deploy solutions in this account."
         },
         {
@@ -92,7 +92,7 @@
                   "url": "https://raw.githubusercontent.com/terraform-ibm-modules/terraform-ibm-account-infrastructure-base/main/reference-architectures/base-account-enterprise.svg",
                   "type": "image/svg+xml"
                 },
-                "description": "Cloud automation for account configuration provides a standardized approach to setting up cloud account settings as outlined in the IBM Cloud Framework for Financial Services. The deployable architecture includes configurations for IAM settings and access controls that enforce security best practices. You can use this deployable architecture as a base for deploying additional services and resources in multiple types of accounts, such as administrative or workload accounts."
+                "description": "Cloud automation for account configuration provides a standardized approach to configure cloud account settings as outlined in the IBM Cloud Framework for Financial Services. The deployable architecture includes configurations for IAM account settings and resource organization that enforce security best practices. You can use this deployable architecture as a base for deploying additional services and resources in multiple types of accounts, such as administrative or workload accounts."
               }
             ]
           },