Readme edits (#227)

Co-authored-by: Kevin Lee <[email protected]>

Author: lavaleri

README.md

@@ -1,18 +1,19 @@
 # AWS Database Encryption SDK for DynamoDB in Java
 
-The AWS Database Encryption SDK for DynamoDB in Java
-provides client-side encryption and signing of Amazon DynamoDB items
-to help you protect your table's data before you send it to DynamoDB.
+The AWS Database Encryption SDK (DB-ESDK) for DynamoDB in Java is a client-side encryption 
+library that allows you to perform attribute-level encryption, enabling you to encrypt specific 
+attribute values within items before storing them in your DynamoDB table. All encryption and 
+decryption are performed within your application. This lets you protect sensitive data in-transit 
+and at-rest, as data cannot be exposed unless decrypted by your application.
 
-For more details about the design and architecture of the
-AWS Database Encryption SDK (DB-ESDK) for DynamoDB, 
+For more details about the design and architecture of the DB-ESDK for DynamoDB, 
 see the [AWS Database Encryption SDK Developer Guide](https://docs.aws.amazon.com/database-encryption-sdk/latest/devguide/).
 
 # Security
 If you discover a potential security issue in this project
 we ask that you notify AWS/Amazon Security via our
 [vulnerability reporting page](http://aws.amazon.com/security/vulnerability-reporting/).
-Please do **not** create a public GitHub issue.
+Please **do not** create a public GitHub issue.
 
 # Support Policy
 See [Support Policy](./SUPPORT_POLICY.rst) for details 
@@ -30,14 +31,14 @@ submitting pull requests through the following channels:
 * Articulate your
   [feature request](https://github.com/aws/aws-database-encryption-sdk-dynamodb-java/issues?q=is%3Aopen+is%3Aissue+label%3A%22feature-request%22)
   or upvote existing ones
+* Ask [questions](https://repost.aws/tags/TAc3VKZnkNQyimpHnCHetNOQ/aws-crypto-tools) on AWS re:Post under AWS Crypto Tools tag
 
 # Getting Started
 
 ## Required Prerequisites
 To use the DB-ESDK for DynamoDB in Java, you must have:
 
 * **A Java 8 or newer development environment**
-
   If you do not have one, 
   go to [Java SE Downloads](https://www.oracle.com/technetwork/java/javase/downloads/index.html) on the Oracle website, 
   then download and install the Java SE Development Kit (JDK). 
@@ -48,11 +49,12 @@ To use the DB-ESDK for DynamoDB in Java, you must have:
   the [Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files](http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html).
 
 * **Declare a Dependency on the DB-ESDK for DynamoDB in Java and it's dependencies**  
-  The DB-ESDK for DynamoDB in Java requires the Dynamodb-Enhanced client
-  from the AWS SDK for Java V2.
-  It also requires the AWS Cryptographic Material Providers library.
+  This library requires the DynamoDB client
+  from the AWS SDK for Java V2
+  and the AwsCryptographicMaterialProviders library.
 
-  The KMS and DynamoDB Clients are **optional** dependencies.
+  The KMS and DynamoDB-Enhanced Clients from the AWS SDK For Java V2
+  are **optional** dependencies.
 
   * **Via Gradle Kotlin**  
    In a Gradle Java Project, add the following to the _dependencies_ section:
@@ -112,35 +114,27 @@ To use the DB-ESDK for DynamoDB in Java, you must have:
   ```
 
 ### AWS Integration
-You need an Amazon Web Services (AWS) account to use
-the AWS Database Encryption SDK for DynamoDB
-(a KMS Key is optional).
+You need an Amazon Web Services (AWS) account to use the DB-ESDK for DynamoDB as it's specifically designed to work with Amazon DynamoDB. Optionally, you can use AWS Key Management Service (AWS KMS) as your main keyring provider.
 
 * **To create an AWS account**, go to 
   [Sign In or Create an AWS Account](https://portal.aws.amazon.com/gp/aws/developer/registration/index.html)
   and then choose **I am a new user.**  
   Follow the instructions to create an AWS account.
 
-* **To create a key in AWS KMS**, see
+* **(Optional) To create a key in AWS KMS**, see
   [Creating Keys](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html).
 
 ### Amazon Corretto Crypto Provider
-Many users find that the Amazon Corretto Crypto Provider (ACCP)
-significantly improves the performance of
-the AWS Database Encryption SDK for DynamoDB in Java.
+Many developers find that the Amazon Corretto Crypto Provider (ACCP)
+significantly improves the performance of the library.
 For help installing and using ACCP, see the 
 [amazon-corretto-crypto-provider repository](https://github.com/corretto/amazon-corretto-crypto-provider).
 
 ## Using the DB-ESDK for DynamoDB in Java
-There are several ways to use the
-AWS Database Encryption SDK (DB-ESDK) for DynamoDB in Java.  
-Please read the
-[AWS Database Encryption SDK Developer Guide](https://docs.aws.amazon.com/database-encryption-sdk/latest/devguide/)
-for guidance.  
-Also see the
-[DynamoDbEncryption Examples](Examples/runtimes/java/DynamoDbEncryption)
-and the 
-[Migration Examples](Examples/runtimes/java/Migration).
+There are several ways to use the library.  
+More details are provided in the
+[AWS Database Encryption SDK Developer Guide](https://docs.aws.amazon.com/database-encryption-sdk/latest/devguide/).  
+Also see the [Examples](Examples/runtimes/java/DynamoDbEncryption).
 
 # Contributing