Would it be possible to improve documentation about expiration / ttl?
Documentation is a bit confusing, sometimes Expiry is mentioned, sometimes TTL, sometimes in milliseconds, sometimes in second, whereas Expiration doc mentions only TTL.
createBucket : BucketSettings has maxTTL
createCollection : collectionspec has maxExpiry
getAndTouch : getAndTouch arguments has expiry
touch touch arguments has expiry
get : get arguments has withExpiry
(not sure i got them all)
The sentence in setting Document expiration is also confusing: “By default, Couchbase documents do not expire. However, the expiration value may be set for the upsert, replace, and insert operations when modifying data.”
It could lead to understand expiration delay/date can be set in upsert, replace, insert, which is not the case. Some examples about changing expiry/ttl after upsert with touch could be given, as in Eventing example.
What about mutatein and lookupin ? do they remove expiration settings of a document as well?