From 761a53dcc53323c3531ab40f8c72425f87685d91 Mon Sep 17 00:00:00 2001
From: Peter Gaultney <pgaultney@xoi.io>
Date: Thu, 22 Jul 2021 15:04:58 -0500
Subject: [PATCH] version 1.15 and document changes

---
 CHANGES.md         | 16 ++++++++++++++++
 xoto3/__about__.py |  2 +-
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/CHANGES.md b/CHANGES.md
index f2e2f77..acd6a72 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -1,3 +1,19 @@
+## 1.15.0
+
+Changes to `versioned_transact_write_items`:
+
+1. Any write to an item that leaves it in its pre-existing state
+   (`==`) will perform only a ConditionCheck and not an actual
+   Put/Delete on that item. This avoids having incrementing
+   `item_version` when nothing was actually changed.
+2. Single-item `versioned_transact_write_items` where the item is
+   unchanged (`==`) performs no ConditionCheck and no spurious
+   write. If you're not operating on multiple items, then there is no
+   meaningful 'transactionality' to knowing whether the item was
+   changed _after_ your transaction started, because transactions
+   can't assert anything about the future - only about a conjunction
+   between multiple items at a point in time.
+
 ## 1.14.0
 
 `StackContext` and `OnCallDefault` utilities for providing new ways of
diff --git a/xoto3/__about__.py b/xoto3/__about__.py
index 784daf4..49879a8 100644
--- a/xoto3/__about__.py
+++ b/xoto3/__about__.py
@@ -1,4 +1,4 @@
 """xoto3"""
-__version__ = "1.14.0"
+__version__ = "1.15.0"
 __author__ = "Peter Gaultney"
 __author_email__ = "pgaultney@xoi.io"