Apply suggestions from code review

Co-authored-by: Scott Gerring <scottgerring@users.noreply.github.com>

Author: jeromevdl

docs/utilities/large_messages.md

@@ -15,7 +15,7 @@ offloaded to S3 if they are larger than the maximum allowed size (256 KB).
 ## Features
 
 - Automatically retrieve the content of S3 objects when SQS or SNS messages have been offloaded to S3.
-- Automatically delete the S3 Objects after processing is OK.
+- Automatically delete the S3 Objects after processing succeeds.
 - Compatible with the batch module (with SQS).
 
 ## Background
@@ -78,7 +78,7 @@ stateDiagram-v2
     
 ```
 
-SQS and SNS message payload is limited to 256KB. If you wish to send larger message payload, you can leverage the
+SQS and SNS message payload is limited to 256KB. If you wish to send messages with a larger payload, you can leverage the
 [amazon-sqs-java-extended-client-lib](https://github.com/awslabs/amazon-sqs-java-extended-client-lib)
 or [amazon-sns-java-extended-client-lib](https://github.com/awslabs/amazon-sns-java-extended-client-lib) which
 offload the message to Amazon S3. See documentation
@@ -89,8 +89,8 @@ When offloaded to S3, the message contains a specific message attribute and the
 S3 object (bucket and object key).
 
 This utility automatically retrieves messages which have been offloaded to S3 using the
-extended client libraries. Once the message payloads have been processed successful, the
-utility also delete the message payloads from S3.
+extended client libraries. Once a message's payload has been processed successfully, the
+utility deletes the payload from S3.
 
 This utility is compatible with
 versions *[1.1.0+](https://github.com/awslabs/amazon-sqs-java-extended-client-lib/releases/tag/1.1.0)*
@@ -377,4 +377,6 @@ If you need to customize this `S3Client`, you can leverage the `LargeMessageConf
   or `SNSEvent.SNSRecord` as first parameter.
 - The annotation now handles a single message, contrary to the previous version that was handling the complete batch.
   It gives more control, especially when dealing with partial failures with SQS (see the batch module).
-- The new module only provides an annotation, the `SqsUtils` is not available anymore in this new version.
+- The new module only provides an annotation, the `SqsUtils` is not available anymore in this new version.
+
+Also, if you are still using the `powertools-sqs` library for batch processing, consider moving to `powertools-batch` at the same time to remove the dependency on this library completely; it has been deprecated and will be removed in v2.

powertools-large-messages/pom.xml

@@ -18,6 +18,8 @@
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
+<description>A suite of utilities for AWS Lambda Functions that makes handling large messages in SQS and SNS easier.</description>
+
     <parent>
         <groupId>software.amazon.lambda</groupId>
         <artifactId>powertools-parent</artifactId>

powertools-large-messages/src/main/java/software/amazon/lambda/powertools/largemessages/LargeMessageProcessingException.java

@@ -14,6 +14,9 @@
 
 package software.amazon.lambda.powertools.largemessages;
 
+/**
+ * Exception that occurs when the utility fails to retrieve the content from S3
+ */
 public class LargeMessageProcessingException extends RuntimeException {
     public LargeMessageProcessingException(String message, Throwable cause) {
         super(message, cause);