spmallette opened a new pull request, #3609:
URL: https://github.com/apache/tinkerpop/pull/3609
The AddE Step section of the reference documentation had a few gaps that
made the `from()`/`to()` behavior hard to learn from the examples alone:
- Callouts 5 and 6 carried **identical** prose ("directed (detached) vertex
references") even though they show fundamentally different patterns.
`g.V(vMarko).addE('knows').to(vPeter)` uses the incoming traverser as the
implicit from-vertex, whereas `g.addE('knows').from(vMarko).to(vPeter)` spawns
the edge from `g` — where there is no traverser to act as a default endpoint,
so both endpoints must be stated explicitly. The two callouts are now distinct
and explain that distinction.
- The `from()`/`to()` argument forms were demonstrated but never stated as a
rule. Added a short introductory note documenting the two canonical forms (a
step-label string and a child traversal), and clarifying that passing a
`Vertex` object directly is convenience syntax exposed by the language variant
(e.g. Gremlin-Java, which resolves the `Vertex` to its id) rather than
canonical Gremlin.
- The cumulative nature of the example block (each `addE()` persists and
edge ids accumulate line to line) was never mentioned; added a note.
- Callout 2's stated edge direction was reversed: the query produces
`lop->josh` and `ripple->josh`, but the prose read "from the josh-vertex to the
lop- and ripple-vertices." Corrected.
Only the AddE Step section prose/callouts were touched; the live examples
are unchanged and still render the same output.
--
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]
