docs: fix links in documentation and update wording (aws#196)

- Update references to JDBC Driver/Wrapper
- Fix broken links
- Rename files and directories to use JDBC Driver instead of JDBC Wrapper

Author: karenc-bq

CHANGELOG.md

@@ -9,9 +9,9 @@ The Amazon Web Services (AWS) Advanced JDBC Wrapper allows an application to tak
 
 ### Added
 * Support for PostgreSQL
-* The [Failover Connection Plugin](./docs/using-the-jdbc-wrapper/using-plugins/UsingTheFailoverPlugin.md)
-* The [Host Monitoring Connection Plugin](./docs/using-the-jdbc-wrapper/using-plugins/UsingTheHostMonitoringPlugin.md)
-* The [AWS IAM Authentication Connection Plugin](./docs/using-the-jdbc-wrapper/using-plugins/UsingTheIamAuthenticationPlugin.md)
-* The [AWS Secrets Manager Connection Plugin](./docs/using-the-jdbc-wrapper/using-plugins/UsingTheAwsSecretsManagerPlugin.md)
+* The [Failover Connection Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheFailoverPlugin.md)
+* The [Host Monitoring Connection Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheHostMonitoringPlugin.md)
+* The [AWS IAM Authentication Connection Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheIamAuthenticationPlugin.md)
+* The [AWS Secrets Manager Connection Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md)
 
 [1.0.0]: https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/tag/1.0.0

README.md

@@ -4,34 +4,34 @@
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
 [![Qodana](https://github.com/awslabs/aws-advanced-jdbc-wrapper/actions/workflows/code_quality.yml/badge.svg)](https://github.com/awslabs/aws-advanced-jdbc-wrapper/actions/workflows/code_quality.yml)
 
-The **Amazon Web Services JDBC Driver** has been redesigned as an advanced JDBC wrapper. This wrapper is complementary to and extends the functionality of an existing JDBC driver to help an application take advantage of the features of clustered databases such as Amazon Aurora. The AWS JDBC wrapper does not implement connectivity on its own to any database, but will enable support of AWS and Aurora functionalities on top of an underlying JDBC driver of the user's choice.
+The **Amazon Web Services JDBC Driver** has been redesigned as an advanced JDBC wrapper. This wrapper is complementary to and extends the functionality of an existing JDBC driver to help an application take advantage of the features of clustered databases such as Amazon Aurora. The AWS JDBC Driver does not implement connectivity on its own to any database, but will enable support of AWS and Aurora functionalities on top of an underlying JDBC driver of the user's choice.
 
-The JDBC wrapper is meant to work with any JDBC driver. Currently, the JDBC wrapper has been validated to support the [PostgreSQL JDBC Driver](https://github.com/pgjdbc/pgjdbc). Support for the [MySQL JDBC Driver](https://github.com/mysql/mysql-connector-j) and the [MariaDB JDBC Driver](https://github.com/mariadb-corporation/mariadb-connector-j) is being evaluated.
+The AWS JDBC Driver is meant to work with any JDBC driver. Currently, the AWS JDBC Driver has been validated to support the [PostgreSQL JDBC Driver](https://github.com/pgjdbc/pgjdbc). Support for the [MySQL JDBC Driver](https://github.com/mysql/mysql-connector-j) and the [MariaDB JDBC Driver](https://github.com/mariadb-corporation/mariadb-connector-j) is being evaluated.
 
-In conjunction with the PostgreSQL JDBC Driver, the AWS JDBC wrapper enables fast failover for Amazon Aurora with PostgreSQL compatibility. It also supports integration with [AWS Identity and Access Management (IAM)](https://aws.amazon.com/iam/) and [AWS Secrets Manager](https://aws.amazon.com/secrets-manager/). We are investigating Read/Write splitting for a future release.
+In conjunction with the PostgreSQL JDBC Driver, the AWS JDBC Driver enables fast failover for Amazon Aurora with PostgreSQL compatibility. It also supports integration with [AWS Identity and Access Management (IAM)](https://aws.amazon.com/iam/) and [AWS Secrets Manager](https://aws.amazon.com/secrets-manager/). We are investigating Read/Write splitting for a future release.
 
 ## About the Driver
 
 ### What is Failover?
 In an Amazon Aurora database (DB) cluster, failover is a mechanism by which Aurora automatically repairs the DB cluster status when a primary DB instance becomes unavailable. It achieves this goal by electing an Aurora Replica to become the new primary DB instance, so that the DB cluster can provide maximum availability to a primary read-write DB instance. The AWS JDBC Driver is designed to coordinate with this behavior in order to provide minimal downtime in the event of a DB instance failure.
 
 ### Benefits of the AWS JDBC Driver
-Although Aurora is able to provide maximum availability through the use of failover, existing client drivers do not currently support this functionality. This is partially due to the time required for the DNS of the new primary DB instance to be fully resolved in order to properly direct the connection. The AWS JDBC wrapper allows customers to continue using their existing community drivers in addition to having the JDBC wrapper fully exploit failover behavior by maintaining a cache of the Aurora cluster topology and each DB instance's role (Aurora Replica or primary DB instance). This topology is provided via a direct query to the Aurora DB, essentially providing a shortcut to bypass the delays caused by DNS resolution. With this knowledge, the AWS JDBC Driver can more closely monitor the Aurora DB cluster status so that a connection to the new primary DB instance can be established as fast as possible. Additionally, as noted above, the AWS JDBC Driver is designed to augment existing JDBC community drivers and be a unified connector to JDBC workflows for Aurora.
+Although Aurora is able to provide maximum availability through the use of failover, existing client drivers do not currently support this functionality. This is partially due to the time required for the DNS of the new primary DB instance to be fully resolved in order to properly direct the connection. The AWS JDBC Driver allows customers to continue using their existing community drivers in addition to having the AWS JDBC Driver fully exploit failover behavior by maintaining a cache of the Aurora cluster topology and each DB instance's role (Aurora Replica or primary DB instance). This topology is provided via a direct query to the Aurora DB, essentially providing a shortcut to bypass the delays caused by DNS resolution. With this knowledge, the AWS JDBC Driver can more closely monitor the Aurora DB cluster status so that a connection to the new primary DB instance can be established as fast as possible. Additionally, as noted above, the AWS JDBC Driver is designed to augment existing JDBC community drivers and be a unified connector to JDBC workflows for Aurora.
 
 #### Enhanced Failure Monitoring
-Enhanced Failure Monitoring (EFM) is a feature available from the [Host Monitoring Connection Plugin](/docs/using-the-jdbc-wrapper/using-plugins/UsingTheHostMonitoringPlugin.md#enhanced-failure-monitoring) that periodically checks the connected database node's health and availability. If a database node is determined to be unhealthy, the connection is aborted.
+Enhanced Failure Monitoring (EFM) is a feature available from the [Host Monitoring Connection Plugin](./docs/using-the-jdbc-driver/using-plugins/UsingTheHostMonitoringPlugin.md#enhanced-failure-monitoring) that periodically checks the connected database node's health and availability. If a database node is determined to be unhealthy, the connection is aborted.
 
 ## Getting Started
-For more information on how to obtain the JDBC wrapper, minimum requirements to use it, and how to integrate the JDBC wrapper into your project, please visit the [Getting Started page](./docs/GettingStarted.md).
+For more information on how to obtain the AWS JDBC Driver, minimum requirements to use it, and how to integrate the AWS JDBC Driver into your project, please visit the [Getting Started page](./docs/GettingStarted.md).
 
-## Using the Wrapper
-Please refer to the JDBC wrapper's [Documentation page](./docs/Documentation.md) for details about using the JDBC wrapper. 
+## Using the AWS JDBC Driver
+Please refer to the AWS JDBC Driver's [Documentation page](./docs/Documentation.md) for details about using the AWS JDBC Driver. 
 
 ## Logging
-To configure logging, check out the [Logging](./docs/using-the-jdbc-wrapper/UsingTheJdbcWrapper.md#logging) section.
+To configure logging, check out the [Logging](./docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#logging) section.
 
 ## Documentation
-Technical documentation regarding the functionality of the AWS JDBC Driver will be maintained in this GitHub repository. Since the JDBC wrapper requires an underlying JDBC driver, please refer to the individual driver's documentation for driver specific information.
+Technical documentation regarding the functionality of the AWS JDBC Driver will be maintained in this GitHub repository. Since the AWS JDBC Driver requires an underlying JDBC driver, please refer to the individual driver's documentation for driver specific information.
 
 ## Getting Help and Opening Issues
 If you encounter a bug with the AWS JDBC Driver, we would like to hear about it.

docs/Documentation.md

@@ -1,19 +1,19 @@
 # Documentation
 
 - [Getting Started](./GettingStarted.md)
-- [Using the AWS Advanced JDBC Wrapper](./using-the-jdbc-wrapper/UsingTheJdbcWrapper.md)
-  - [Data Sources](./using-the-jdbc-wrapper/DataSource.md)
-  - [Logging](./using-the-jdbc-wrapper/UsingTheJdbcWrapper.md#logging)
-  - [JDBC Wrapper Parameters](./using-the-jdbc-wrapper/UsingTheJdbcWrapper.md#aws-advanced-jdbc-wrapper-parameters)
-  - [Plugins](./using-the-jdbc-wrapper/UsingTheJdbcWrapper.md#plugins)
-    - [Failover Plugin](./using-the-jdbc-wrapper/using-plugins/UsingTheFailoverPlugin.md)
-      - [Failover Configuration Guide](using-the-jdbc-wrapper/FailoverConfigurationGuide.md)
-    - [Host Monitoring Plugin](./using-the-jdbc-wrapper/using-plugins/UsingTheHostMonitoringPlugin.md)
-    - [IAM Authentication Plugin](./using-the-jdbc-wrapper/using-plugins/UsingTheIamAuthenticationPlugin.md)
-    - [AWS Secrets Manager Plugin](./using-the-jdbc-wrapper/using-plugins/UsingTheAwsSecretsManagerPlugin.md)
+- [Using the AWS Advanced JDBC Wrapper](/docs/using-the-jdbc-driver/UsingTheJdbcDriver.md)
+  - [Data Sources](/docs/using-the-jdbc-driver/DataSource.md)
+  - [Logging](/docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#logging)
+  - [JDBC Wrapper Parameters](/docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#aws-advanced-jdbc-driver-parameters)
+  - [Plugins](/docs/using-the-jdbc-driver/UsingTheJdbcDriver.md#plugins)
+    - [Failover Plugin](/docs/using-the-jdbc-driver/using-plugins/UsingTheFailoverPlugin.md)
+      - [Failover Configuration Guide](/docs/using-the-jdbc-driver/FailoverConfigurationGuide.md)
+    - [Host Monitoring Plugin](/docs/using-the-jdbc-driver/using-plugins/UsingTheHostMonitoringPlugin.md)
+    - [IAM Authentication Plugin](/docs/using-the-jdbc-driver/using-plugins/UsingTheIamAuthenticationPlugin.md)
+    - [AWS Secrets Manager Plugin](/docs/using-the-jdbc-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md)
 - [Development Guide](./development-guide/DevelopmentGuide.md)
   - [Setup](./development-guide/DevelopmentGuide.md#setup)
-  - [Building the AWS Advanced JDBC Wrapper](./development-guide/DevelopmentGuide.md#building-the-aws-advanced-jdbc-wrapper)
+  - [Building the AWS Advanced JDBC Driver](./development-guide/DevelopmentGuide.md#building-the-aws-advanced-jdbc-driver)
   - [Running the Tests](./development-guide/DevelopmentGuide.md#running-the-tests)
   - [Architecture](./development-guide/Architecture.md)
     - [Plugin Manager](./development-guide/PluginManager.md)

docs/GettingStarted.md

@@ -2,13 +2,13 @@
 
 ## Minimum Requirements
 
-Before using the AWS Advanced JDBC Wrapper, you must install:
+Before using the AWS Advanced JDBC Driver, you must install:
 
 - Amazon Corretto 8+ or Java 8+.
-- The AWS Advanced JDBC Wrapper.
+- The AWS Advanced JDBC Driver.
 - Your choice of underlying JDBC driver. To use the wrapper with Aurora with PostgreSQL compatibility, you need to install the [PostgreSQL JDBC Driver](https://github.com/pgjdbc/pgjdbc).
 
-If you are using the wrapper as part of a Gradle project, include the wrapper and underlying driver as dependencies.  For example, to include the AWS Advanced JDBC Wrapper and the PostgreSQL JDBC Driver as dependencies in a Gradle project, update the ```build.gradle``` file as follows:
+If you are using the AWS JDBC Driver as part of a Gradle project, include the wrapper and underlying driver as dependencies.  For example, to include the AWS Advanced JDBC Driver and the PostgreSQL JDBC Driver as dependencies in a Gradle project, update the ```build.gradle``` file as follows:
 
 ```gradle
 dependencies {
@@ -17,27 +17,27 @@ dependencies {
 }
 ```
 
-## Obtaining the AWS Advanced JDBC Wrapper
+## Obtaining the AWS Advanced JDBC Driver
 
 ### Direct Download and Installation
 
-You can use pre-compiled packages that can be downloaded directly from [GitHub Releases](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases) or [Maven Central](https://search.maven.org/search?q=g:software.amazon.jdbc) to install the AWS Advanced JDBC Wrapper. After downloading the wrapper, install the wrapper by including the .jar file in the application's CLASSPATH.
+You can use pre-compiled packages that can be downloaded directly from [GitHub Releases](https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases) or [Maven Central](https://search.maven.org/search?q=g:software.amazon.jdbc) to install the AWS Advanced JDBC Driver. After downloading the AWS JDBC Driver, install it by including the .jar file in the application's CLASSPATH.
 
 For example, the following command uses wget to download the wrapper:
 
 ```bash
 wget https://github.com/awslabs/aws-advanced-jdbc-wrapper/releases/download/1.0.0/aws-advanced-jdbc-wrapper-1.0.0.jar
 ```
 
-Then, the following command adds the JDBC wrapper to the CLASSPATH:
+Then, the following command adds the AWS JDBC Driver to the CLASSPATH:
 
 ```bash
 export CLASSPATH=$CLASSPATH:/home/userx/libs/aws-advanced-jdbc-wrapper-1.0.0.jar
 ```
 
 ### As a Maven Dependency
 
-You can use [Maven's dependency management](https://search.maven.org/search?q=g:software.amazon.jdbc) to obtain the JDBC Wrapper by adding the following configuration to the application's Project Object Model (POM) file:
+You can use [Maven's dependency management](https://search.maven.org/search?q=g:software.amazon.jdbc) to obtain the AWS JDBC Driver by adding the following configuration to the application's Project Object Model (POM) file:
 
 ```xml
 <dependencies>
@@ -51,7 +51,7 @@ You can use [Maven's dependency management](https://search.maven.org/search?q=g:
 
 ### As a Gradle Dependency
 
-You can use [Gradle's dependency management](https://search.maven.org/search?q=g:software.amazon.jdbc) to obtain the JDBC Wrapper by adding the following configuration to the application's ```build.gradle``` file:
+You can use [Gradle's dependency management](https://search.maven.org/search?q=g:software.amazon.jdbc) to obtain the AWS JDBC Driver by adding the following configuration to the application's ```build.gradle``` file:
 
 ```gradle
 dependencies {
@@ -67,6 +67,6 @@ dependencies {
 }
 ```
 
-## Using the AWS Advanced JDBC Wrapper
+## Using the AWS Advanced JDBC Driver
 
-For more detailed information about how to use and configure the JDBC Wrapper, please visit [this page](./using-the-jdbc-wrapper/UsingTheJdbcWrapper.md).
+For more detailed information about how to use and configure the AWS JDBC Driver, please visit [this page](using-the-jdbc-driver/UsingTheJdbcDriver.md).

docs/development-guide/Architecture.md

@@ -2,7 +2,7 @@
 
 <div style="center"><img src="../images/plugin_manager.png" alt="diagram on how plugin manager is integrated with the user application"/></div>
 
-The AWS Advanced JDBC Wrapper contains 5 main components:
+The AWS Advanced JDBC Driver contains 5 main components:
 
 1. The wrapper classes
 2. The [connection plugin manager](./PluginManager.md)