OK, I'll provide a pull request for the docs, perhaps in the form of a
short section with a heading 'Migrating from TP2'
Cheers,
Bryn
On 28/09/15 20:18, Stephen Mallette wrote:
My answer wasn't great - let me add a little more. I don't think we should
generally go to naming TraversalSource as "ts" because the name you give to
this variable should generally be representative of the context of the
TraversalSource itself. This ultimately ties all the way up to Gremlin
Server in how you reference the TraversalSource you want to refer to and
there are multiple TraversalSource objects at play. We need to continue to
convey to folks that they should think of "g" as a default name when you
have a single source configured. I know that might not eliminate the
initial confusion for folks, but I think we've discussed the naming of "g"
before and that any initial confusion should probably be short-lived.
+1 for a CAUTION: as suggested by Marko.
On Mon, Sep 28, 2015 at 3:00 PM, Marko Rodriguez <[email protected]>
wrote:
Hi,
Bryn: you could provide a pull request for some sort of blockquote that
explains the distinction so it makes it easier for the community (as a
permeating entity across all space and time) to know whats going on.
E.g.
CAUTION: In TinkerPop3, `g`….in TinkerPop3…
Marko.
http://markorodriguez.com
On Sep 28, 2015, at 12:56 PM, Stephen Mallette <[email protected]>
wrote:
I dunno, Bryn. I kinda get your point, but:
ts.V()
looks so wrong - however:
g.V()
ahhh - all is right with the universe. :D
On Mon, Sep 28, 2015 at 2:50 PM, Bryn Cooke <[email protected]> wrote:
Hi Tinkerpop,
I have fielded a couple of questions from some new Tinkerpop 3 users
recently and wonder if a slight tweak to the docs could make things
easier
for those coming from TP2.
g = graph.traversal(standard())
For TP2 users this line is easy to miss, many people will just skim the
docs rather than read them from start to finish.
This is compounded by the fact that g was used as the 'graph' variable
in
TP2 docs. The solution:
ts = graph.traversal(standard())
The object is a traversal source anyway, so calling it 'g' makes no
sense
even for new TP users.
Cheers,
Bryn
