Added upgrade docs for tx() in javascript CTR

spmallette · spmallette · commit 7e833259d76d · 2021-07-15T09:45:10.000-04:00
diff --git a/docs/src/reference/the-traversal.asciidoc b/docs/src/reference/the-traversal.asciidoc
@@ -288,8 +288,10 @@ the <<sessions,Considering Sessions>> Section.
 === Remote Gremlin Providers
 
 At this time, transactional patterns for Remote Gremlin Providers are largely in line with Gremlin Server. As most of
-RGPs do not expose a `Graph` instance, access to lower level transactional functions even in a sessionless fashion are
-not typically permitted. The nature of what a "transaction" means will be dependent on the RGP as is the case with any
+RGPs do not expose a `Graph` instance, access to lower level transactional functions available to embedded graphs
+even in a sessionless fashion are not typically permitted. For example, without a `Graph` instance it is not possible
+to link:https://tinkerpop.apache.org/docs/current/reference/#tx-embedded[configure] transaction close or read-write
+behaviors. The nature of what a "transaction" means will be dependent on the RGP as is the case with any
 TinkerPop-enabled graph system, so it is important to consult that systems documentation for more details.
 
 [[configuration-steps]]
diff --git a/docs/src/upgrade/release-3.5.x.asciidoc b/docs/src/upgrade/release-3.5.x.asciidoc
@@ -28,6 +28,16 @@ image::https://raw.githubusercontent.com/apache/tinkerpop/master/docs/static/ima
 Please see the link:https://github.com/apache/tinkerpop/blob/3.5.1/CHANGELOG.asciidoc#release-3.5.1[changelog] for a
 complete list of all the modifications that are part of this release.
 
+=== Upgrading for Users
+
+==== tx() in Javascript
+
+Javascript is now the first non-JVM variant of Gremlin to get support for
+link:https://tinkerpop.apache.org/docs/3.5.1/reference/#transactions[remote transactions]. An example of the `tx()`
+syntax can be found in the Javascript link:https://tinkerpop.apache.org/docs/3.5.1/reference/#gremlin-javascript-transactions[Transaction Section].
+
+See: link:https://issues.apache.org/jira/browse/TINKERPOP-2557[TINKERPOP-2557]
+
 == TinkerPop 3.5.0
 
 *Release Date: May 3, 2021*
