dah - sorry, i'm new to this internet thing apparently On Tue, Jan 26, 2016 at 2:41 PM, Marko Rodriguez <[email protected]> wrote:
> Hi, > > You mean: > > http://tinkerpop.apache.org/docs/3.1.1-SNAPSHOT/tutorials/the-gremlin-console/ > > Marko. > > http://markorodriguez.com > > On Jan 26, 2016, at 12:21 PM, Stephen Mallette <[email protected]> > wrote: > > > I moved the tutorial as marko suggested - the new URL is: > > > > > http://tinkerpop.apache.org/docs/3.1.1-SNAPSHOT/tutorials/advanced-console/ > > > > On Tue, Jan 26, 2016 at 8:44 AM, Stephen Mallette <[email protected]> > > wrote: > > > >> wow - i was about to test all the urls today. wonder why they're all > >> hosed up. thanks. > >> > >> On Tue, Jan 26, 2016 at 8:41 AM, Marko Rodriguez <[email protected]> > >> wrote: > >> > >>> Hello, > >>> > >>> First off Stephen, this is a beautiful tutorial. Well done. Nice > graphics > >>> too :D. > >>> > >>> Here is a list of comments for you to do with as you please: > >>> > >>> * Its called "The Gremlin Console" but the URL is > >>> advanced-console. I would renamed the file to the-gremlin-console. > >>> * "The First Five Minutes" link is bad. > >>> * "reference documentation" link is bad. > >>> * "features of the Gremlin Console, through a number " … no > comma > >>> needed between Console and through. > >>> * "The following points summarize the key features discussed in > >>> each of the use cases:" should read "The following points summarize > the key > >>> features of each use case:" > >>> * I would have an IMPORTANT saying why graph and g are different > >>> right after your first code snippet. > >>> * createTheCrew needs to be createTheCrew(). > >>> * Lots of bad URLs in the "A Learning Tool" section. Check them > >>> all out. > >>> * Note that "reference documentation" is now nested in the > >>> directory structure of our docs :| … thus, all such links are bad. > >>> * I would add an IMPORTANT about import static > >>> org.apache.tinkerpop.gremlin.process.traversal.dsl.graph.__.*; > >>> * "it iterates the entries() " should be "it iterates the > >>> entrySet()". > >>> * "It is possible to prevent auto-iteration" doesn't need to be > a > >>> new paragraph. > >>> * g.V().has('name', name).drop(); --- your Java examples need " > >>> not ' … i.e. "name" (there are a couple of these) > >>> * The first reference to Cassandra should say "Apache Cassandra" > >>> and URL link to it. > >>> * When you mention "firstYear" you should say something like > >>> "note that we use next() to get the value and save it to the variable." > >>> * Your code examples have some extreme indenting here and there. > >>> Might want to tighten that up. > >>> * I would not use sideEffect{} in your last example. Instead use > >>> forEachRemaining{ }… This way there is no "it" to explain and its more > >>> natural as it both iterates() (is terminal) and you don't need the > ;null. > >>> > >>> Man…what an epic piece of work. You must feel good about yourself. > >>> > >>> Take care, > >>> Marko. > >>> > >>> http://markorodriguez.com > >>> > >>> On Jan 25, 2016, at 6:06 PM, Stephen Mallette <[email protected]> > >>> wrote: > >>> > >>>> To keep with the pattern of having at least one new tutorial with > every > >>>> release, I wrote a fresh tutorial about the Gremlin Console. It seeks > >>> to > >>>> address the kinds of questions we repeatedly get over and over again > >>> while > >>>> providing some common use cases. It will be nice to reply to folks > with > >>>> links to parts of this tutorial rather than having to type the same > >>> answers > >>>> over and over again. I took the same approach as the last tutorial > and > >>>> sought a familiar style with copious use of the word "you" - a style > of > >>>> writing I sorta struggle with, but again, i think that style is good > for > >>>> the "tutorial" pattern. > >>>> > >>>> > >>> > http://tinkerpop.apache.org/docs/3.1.1-SNAPSHOT/tutorials/advanced-console/ > >>>> > >>>> Anyway, please feel free to provide some feedback so that I can get > this > >>>> guy finalized in time for 3.1.1-incubating next week. > >>> > >>> > >> > >
