Fixing the documentation for UpdateItemEnhancedResponse to correctly describe which return values the attributes have (#3881)

Author: cenedhryn

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

@@ -23,6 +23,7 @@
 import software.amazon.awssdk.enhanced.dynamodb.DynamoDbTable;
 import software.amazon.awssdk.services.dynamodb.model.ConsumedCapacity;
 import software.amazon.awssdk.services.dynamodb.model.ItemCollectionMetrics;
+import software.amazon.awssdk.services.dynamodb.model.ReturnValue;
 import software.amazon.awssdk.services.dynamodb.model.UpdateItemResponse;
 
 /**
@@ -46,7 +47,8 @@ private UpdateItemEnhancedResponse(Builder<T> builder) {
     }
 
     /**
-     * The attribute values as they appeared before the {@code UpdateItem} operation.
+     * The returned attribute values. These correspond to the DynamoDB {@link ReturnValue} setting. By default,
+     * the attributes reflect the values after the {@code UpdateItem} operation has been applied ({@link ReturnValue#ALL_NEW}).
      */
     public T attributes() {
         return attributes;