diff --git a/tempest/src/main/kotlin/app/cash/tempest/LogicalDb.kt b/tempest/src/main/kotlin/app/cash/tempest/LogicalDb.kt
index d87e89095..f00fd98a9 100644
--- a/tempest/src/main/kotlin/app/cash/tempest/LogicalDb.kt
+++ b/tempest/src/main/kotlin/app/cash/tempest/LogicalDb.kt
@@ -114,9 +114,9 @@ interface LogicalDb : LogicalTable.Factory {
    * Transactionally writes objects specified by transactionWriteRequest by calling
    * [AmazonDynamoDB.transactWriteItems] API.
    *
-   * This method does not support versioning annotations. It throws
-   * [com.amazonaws.SdkClientException] exception if class of any input object is annotated
-   * with [DynamoDBVersionAttribute] or [DynamoDBVersioned].
+   * This method supports versioning annotations, but not in conjunction with condition expressions.
+   * It throws [com.amazonaws.SdkClientException] exception if class of any input object is annotated
+   * with [DynamoDBVersionAttribute] or [DynamoDBVersioned] and a condition expression is also present.
    *
    * A transaction cannot contain more than 25 unique items, including conditions.
    * A transaction cannot contain more than 4 MB of data.
diff --git a/tempest2/src/main/kotlin/app/cash/tempest2/LogicalDb.kt b/tempest2/src/main/kotlin/app/cash/tempest2/LogicalDb.kt
index 8b72701e5..9f9d1d3e1 100644
--- a/tempest2/src/main/kotlin/app/cash/tempest2/LogicalDb.kt
+++ b/tempest2/src/main/kotlin/app/cash/tempest2/LogicalDb.kt
@@ -103,9 +103,10 @@ interface LogicalDb : LogicalTable.Factory {
    * Transactionally writes objects specified by transactionWriteRequest by calling
    * [DynamoDbClient.transactWriteItems] API.
    *
-   * This method does not support versioning annotations. It throws
-   * [software.amazon.awssdk.core.exception.SdkClientException] exception if class of any input
-   * object is annotated with [DynamoDbVersionAttribute].
+   * This method supports versioning annotations, but not in conjunction with condition expressions.
+   * It throws [software.amazon.awssdk.core.exception.SdkClientException] exception if class of
+   * any input object is annotated with [DynamoDbVersionAttribute] and a condition expression is
+   * also present.
    *
    * A transaction cannot contain more than 25 unique items, including conditions.
    * A transaction cannot contain more than 4 MB of data.