Docs: Clarifying BatchWriteItem limits (#3519)

* Docs: Clarifying BatchWriteItem limits

Author: debora-ito

services-custom/dynamodb-enhanced/src/main/java/software/amazon/awssdk/enhanced/dynamodb/DynamoDbEnhancedClient.java

@@ -168,6 +168,9 @@ default BatchGetResultPageIterable batchGetItem(Consumer<BatchGetItemEnhancedReq
      * The additional configuration parameters that the enhanced client supports are defined
      * in the {@link BatchWriteItemEnhancedRequest}.
      * <p>
+     * A single call to BatchWriteItem has the same limit of items as the low-level DynamoDB API BatchWriteItem operation,
+     * considering all items across all WriteBatches.
+     * <p>
      * <b>Note: </b> BatchWriteItem cannot update items. Instead, use the individual updateItem operation
      * {@link DynamoDbTable#updateItem(UpdateItemEnhancedRequest)}.
      * <p>
@@ -218,6 +221,9 @@ default BatchWriteResult batchWriteItem(BatchWriteItemEnhancedRequest request) {
      * The additional configuration parameters that the enhanced client supports are defined
      * in the {@link BatchWriteItemEnhancedRequest}.
      * <p>
+     * A single call to BatchWriteItem has the same limit of items as the low-level DynamoDB API BatchWriteItem operation,
+     * considering all items across all WriteBatches.
+     * <p>
      * <b>Note: </b> BatchWriteItem cannot update items. Instead, use the individual updateItem operation
      * {@link DynamoDbTable#updateItem(UpdateItemEnhancedRequest)}.
      * <p>

services-custom/dynamodb-enhanced/src/main/java/software/amazon/awssdk/enhanced/dynamodb/DynamoDbTable.java

@@ -851,7 +851,7 @@ default void deleteTable() {
     }
 
     /**
-     * Describes a table in DynamoDb with the name defined for this {@link DynamoDbTable).
+     * Describes a table in DynamoDb with the name defined for this {@link DynamoDbTable}.
      * This operation calls the low-level DynamoDB API DescribeTable operation,
      * see {@link DynamoDbClient#describeTable(DescribeTableRequest)}
      * <p>