Counters & TTL

DOC-11523

Author: RichardSmedley

modules/howtos/pages/kv-operations.adoc

@@ -154,6 +154,8 @@ include::{version-server}@sdk:shared:partial$documents.adoc[tag=exp-note]
 
 The value of a document can be increased or decreased atomically using `binary().increment()` and `binary().decrement()`.
 
+NOTE: Increment & Decrement are considered part of the ‘binary’ API and as such may still be subject to change.
+
 .Increment
 [source,javascript]
 ----
@@ -178,8 +180,10 @@ include::devguide:example$nodejs/kv-operations.js[tag=decrement,indent=0]
 include::devguide:example$nodejs/kv-operations.js[tag=decrementwithoptions,indent=0]
 ----
 
-NOTE: Increment & Decrement are considered part of the ‘binary’ API and as such may still be subject to change
+TIP: Setting the document expiry time only works when a document is created, and it is not possible to update the expiry time of an existing counter document with the Increment method -- to do this during an increment, use with the `Touch()` method.
+
 
+// Atomicity Across Data Centers
 
 include::7.1@sdk:shared:partial$atomic.adoc[tag=xdcr]