andreachild commented on code in PR #3215:
URL: https://github.com/apache/tinkerpop/pull/3215#discussion_r2380015583


##########
docs/src/upgrade/release-3.8.x.asciidoc:
##########
@@ -888,6 +874,41 @@ pinned variable is one which must remain bound to the 
current value. By paramete
 variable, as it can be substituted in the optimized traversal without any loss 
of meaning, however the variable "count"
 will be pinned as the optimized traversal is not valid for other values of 
"count".
 
+===== Decouple internal step state from `Configuring`/`Parameterizing` 
interfaces
+
+Previously `AddVertexStep`, `AddVertexStartStep`, `AddEdgeStep`, 
`AddEdgeStartStep`, and `AddPropertyStep` stored their
+internal state (id, label, properties, from/to vertices...) in a `Parameters` 
object which was exposed via the
+`Configuring` and `Parameterizing` interfaces. These interfaces are primarily 
intended to support with()-modulation, and
+thus these steps had weird unintended behaviors when combined with 
with()-modulation:
+
+[source,text]
+----
+gremlin> g.addV().with("name", "cole").valueMap()
+==>[name:[cole]]

Review Comment:
   What is this example intended to inform? Is it just an example of usage of 
`with`? I'm guessing it's supposed to demonstrate how it's odd to be able to 
set properties using `with()`? Regardless please specify what is unexpected 
about this example.



-- 
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]

Reply via email to