Sync main with dev

en/docs/develop-components/sharing-and-reusing/create-a-connection.md

@@ -2,12 +2,14 @@
 
 Connections in Choreo provide a simple and uniform approach to seamlessly integrate components with services or resources.
 
-Choreo allows you to create connections to services deployed in Choreo and to Choreo-managed databases.
+Choreo allows you to create connections to services deployed in Choreo or registered as external services. It also allows you to create connections to any Choreo-managed database.
 
 To create a connection to a service or a database, follow the step-by-step instructions in the respective tab:
 
 === "Create a connection to a service"
 
+    <h2>Create a connection to a Choreo service</h2>
+
     Follow these steps to create a connection to a service deployed in Choreo:
 
     1. In the Choreo Console, go to the top navigation menu and set the visibility level as [project](../../choreo-concepts/connections.md#project-connections) or [component](../../choreo-concepts/connections.md#component-connections) as follows: 
@@ -23,10 +25,18 @@ To create a connection to a service or a database, follow the step-by-step instr
     7. Click **Create**.
 
     This creates the connection and displays its details for each environment, along with an inline guide on how to use the connection in your component. 
-
-    For step-by-step instructions on using a connection in your service, see [Use a Connection in Your Service](./use-a-connection-in-your-service.md).
 
-    For step-by-step instructions on using a connection in your web application, see [Use a Connection in Your Web Application](./use-a-connection-in-your-web-application.md).
+    <h2>Create a connection to an external service</h2>
+
+    Follow these steps to create a connection to an external service:
+
+    1. Follow steps 1–5 from the previous section.
+    2. Expand the **Environment to Endpoint** section and verify the service endpoints assigned to the Choreo environments.
+    3. Click **Create**.
+
+      For step-by-step instructions on using a connection in your service, see [Use a Connection in Your Service](./use-a-connection-in-your-service.md).
+
+      For step-by-step instructions on using a connection in your web application, see [Use a Connection in Your Web Application](./use-a-connection-in-your-web-application.md).
 
 
 === "Create a connection to a database"

en/docs/integrate-and-manage-external-services/integrate-and-manage-gen-ai-services.md

@@ -61,7 +61,7 @@ If you want to remove the service from the Internal Marketplace, see [Remove a G
 
 The GenAI services you register are discoverable via the Internal Marketplace for you to consume via a Connection.
 
-For details on consuming a GenAI service via a connection, see [Create a Connection](../develop-components/sharing-and-reusing/create-a-connection.md#create-a-connection-to-an-external-service).
+For details on consuming a GenAI service via a connection, see [Create a Connection](../develop-components/sharing-and-reusing/create-a-connection.md).
 
 ## Manage GenAI services
 

en/mkdocs.yml

@@ -130,6 +130,9 @@ nav:
       - Configure Endpoints: develop-components/configure-endpoints.md
       - Manage Component Source Configurations: develop-components/manage-component-source-configurations.md
       - Develop Components Using VS Code: develop-components/develop-components-using-vs-code.md
+  - Integrate and Manage External Services: 
+      - Integrate and Manage Third-Party Services: integrate-and-manage-external-services/integrate-and-manage-third-party-services.md
+      - Integrate and Manage Generative AI Services: integrate-and-manage-external-services/integrate-and-manage-gen-ai-services.md
   - Choreo-Managed Databases and Caches: 
           - Overview: manage-databases-and-caches/choreo-managed-databases-and-caches.md
           - PostgreSQL:  manage-databases-and-caches/choreo-managed-postgresql-databases.md