spmallette commented on code in PR #3458:
URL: https://github.com/apache/tinkerpop/pull/3458#discussion_r3443190290
##########
docs/src/upgrade/release-4.x.x.asciidoc:
##########
@@ -101,6 +70,51 @@ partial work is discarded if the user forgets to call
`commit()`. In Java (both
can still be overridden via `tx.onClose(Transaction.CLOSE_BEHAVIOR.COMMIT)`.
The non-Java GLVs do not support
configuring close behavior and always rollback.
+==== Expanding Dynamic Arguments to Additional Steps
+
+Prior to 4.0, comparing a traverser's value against a dynamically computed
reference required verbose workarounds with
+`where()`, `select()`, and labeled steps. For example, finding all people
older than "marko" previously required:
+
+[source,groovy]
+----
+// Old way: label marko's age, compare via where()
+g.V(1).values("age").as("markosAge").
+ V().hasLabel("person").as("p").
+ values("age").as("otherAge").
+ where("otherAge", gt("markosAge")).
+ select("p").values("name")
+----
+
+This pattern was unintuitive and could not easily compose with other
predicates. With traversal-accepting arguments,
Review Comment:
"unintuitive" - better to say, "This pattern required several coordinated
step labels and `where()` compartison" and let the reader decide if it is
unintuitive or not.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
