Hi, Bryn, if you do a "Migrating from TinkerPop2" section, can you please go through and grab all the NOTE:, IMPORTANT:, CAUTION: pull out block quotes throughout that are of that vein (i.e. those that are like "In TinkerPop2, blah blah blah…"). There are also some non-blockquotes and images here and there that can be pulled into your section (in particular a part about Traversers).
Thanks, Marko. http://markorodriguez.com On Sep 29, 2015, at 7:04 AM, Stephen Mallette <[email protected]> wrote: > I think folks would find a "Migrating from TP2" section helpful. Sounds > good to me...thanks. > > On Tue, Sep 29, 2015 at 7:47 AM, Bryn Cooke <[email protected]> wrote: > >> 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 >>>>>> >>>>>> >>>>>> >>>> >>
