Address Review Comment

Author: MouhsinElmajdouby

ojdbc-provider-aws/README.md

@@ -161,19 +161,21 @@ configuration parameters should be loaded using AWS AppConfig. Users need to spe
 A URL with the following format is valid:
 
 <pre>
-jdbc:oracle:thin:@config-awsappconfig://{application-identifier}[?appconfig_environment={your-environment}&appconfig_profile={your-profile}]
+jdbc:oracle:thin:@config-awsappconfig://{application-identifier}[?appconfig_environment={environment-id-or-name}&appconfig_profile={profile-id-or-name}]
 </pre>
 
+All three values are required for the AppConfig Freeform Configuration Provider:
 
-The `{application-identifier}` can be either the application ID or name as defined in [AWS AppConfig](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/appconfigdata/AppConfigDataClient.html). 
-The environment and configuration profile can be specified in the URL,
+ - `{application-identifier}`: the name or ID of your AppConfig application, as defined in [AWS AppConfig](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/appconfigdata/AppConfigDataClient.html). This must be provided directly in the URL.
+ - `{environment-id-or-name}`: the name or ID of the environment within the application (e.g., dev, prod). This can be provided as a URL parameter (`appconfig_environment`), a system property (`aws.appconfig.environment`), or an environment variable (`AWS_APP_CONFIG_ENVIRONMENT`).
+ - `{profile-id-or-name}`: the name or ID of the configuration profile that contains your settings. This can be provided as a URL parameter (`appconfig_profile`), a system property (`aws.appconfig.profile`), or an environment variable (`AWS_APP_CONFIG_PROFILE`).
 
-for example:
+Example using all parameters in the URL:
 <pre>
 jdbc:oracle:thin:@config-awsappconfig://app-name?appconfig_environment=your-environment&appconfig_profile=your-profile
 </pre>
 
-Alternatively, you can set them via system properties (`aws.appconfig.environment, aws.appconfig.profile`) or
+Alternatively, you can set the environment and profile via system properties (`aws.appconfig.environment, aws.appconfig.profile`) or
 environment variables (`AWS_APP_CONFIG_ENVIRONMENT, AWS_APP_CONFIG_PROFILE`).
 
 ## Common Parameters for Centralized Config Providers