Speaking as an application developer that experienced the introduction of the TraversalSource API, I can appreciate Bryn's perspective. However, I felt that "g" was more effective as a drop-in replacement for almost every piece of code where a TraversalSource was required (where previously a Graph had been). I made the change to use "graph" as the name of my Graph object. I also mentally redirected "g" to be an abbreviation for "Gremlin" ;)
On Mon, Sep 28, 2015 at 11:50 AM, 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 > >
