diff --git a/multicloud/azure-cli/README.md b/multicloud/azure-cli/README.md
index ee7ff2f..37da994 100644
--- a/multicloud/azure-cli/README.md
+++ b/multicloud/azure-cli/README.md
@@ -11,8 +11,14 @@ The steps below show how to create an Autonomous Database using the Azure CLI.
 * [Subscribe to Oracle Database@Azure](https://www.youtube.com/watch?v=MEB8kB_TI2I) 
 * Ensure you have the appropriate user groups and privileges. See [details for onboarding Autonomous Database](https://learn.microsoft.com/en-us/azure/oracle/oracle-db/onboard-oracle-database)
 
-## Deploy your Autonomous Database
-Use the following scripts to deploy your infrastructure and Autonomous Database. You can run the scripts independently or run `create-all-resources.sh`. Simply update the [`config`](#configuration-file) prior to running the scripts:
+## Deploy your Autonomous Database and your infrastructure
+Use the following scripts to deploy your infrastructure and Autonomous Database:
+
+![deployment](../images/azure-deployment.png)
+
+**Note:** Azure OpenAI is used by the samples - but the scripts do not deploy the resource.
+f
+You can run the scripts independently or run `create-all-resources.sh`. Simply update the [`config`](#configuration-file) prior to running the scripts:
 
 |Script|Description|
 |----|---|
diff --git a/multicloud/images/azure-deployment.png b/multicloud/images/azure-deployment.png
new file mode 100644
index 0000000..39a9366
Binary files /dev/null and b/multicloud/images/azure-deployment.png differ
diff --git a/multicloud/images/connection-console-oci.png b/multicloud/images/connection-console-oci.png
new file mode 100644
index 0000000..e56bc72
Binary files /dev/null and b/multicloud/images/connection-console-oci.png differ
diff --git a/multicloud/images/oci-adb-github-samples.drawio.png b/multicloud/images/oci-adb-github-samples.drawio.png
new file mode 100644
index 0000000..9cfa07b
Binary files /dev/null and b/multicloud/images/oci-adb-github-samples.drawio.png differ
diff --git a/multicloud/oci-cli/README.md b/multicloud/oci-cli/README.md
index 2159d3f..86e06cc 100644
--- a/multicloud/oci-cli/README.md
+++ b/multicloud/oci-cli/README.md
@@ -15,7 +15,11 @@ The steps below show how to create an Autonomous Database using the OCI CLI.
     * [Use OCI Object Storage](https://docs.oracle.com/en-us/iaas/Content/Security/Reference/objectstorage_security.htm#iam-policies)
 
 ## Deploy your Autonomous Database
-Use the following scripts to deploy your Autonomous Database and sample data. You can run the scripts independently or run `create-all-resources.sh`. Simply update the [`config`](#configuration-file) prior to running the scripts:
+Use the following scripts to deploy your Autonomous Database and sample data on OCI. Because the sample script deploys ADB on a public endpoint, the architecture is very simple: 
+
+![ADB on OCI](../images/oci-adb-github-samples.drawio.png)
+
+You can run the scripts independently or run `create-all-resources.sh`. Simply update the [`config`](#configuration-file) prior to running the scripts:
 
 |Script|Description|
 |----|---|
@@ -66,9 +70,10 @@ JDBC is a common way to connect to Autonomous Database. For example, you can use
 
 Notice the `jdbc:oracle:thin:@` prefix followed by a connection string. You can find the connection string in different ways. 
 
-1. Go to your Autonomous Database blade in the Azure Portal and go to **Settings -> Connections**:
-    ![Azure Portal connections](../images/connections-portal.png)
-2. Use the Azure cli script [`show-adb-info.sh`](./show-adb-info.sh). That script will return information about your Autonomous Database, including connection details.
+1. Go to your Autonomous Database instance in the OCI Console and click **Database Connections**:
+![connection dialog](../images/connection-console-oci.png)
+
+2. Use the OCI cli script [`show-adb-info.sh`](./show-adb-info.sh). That script will return information about your Autonomous Database, including connection details.
 
 <hr>
 Copyright (c) 2024 Oracle and/or its affiliates.<br>