You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tinkerpop.apache.org by Christos Oikonomou <ch...@gmail.com> on 2015/04/22 20:01:15 UTC
Re: Contributing to tinkerpop3
Hello everyone,
I have read your advices how to start and how to be familiarized with the
codebase. After some time I spent exploring the code, I believe I am ready
to start specific changes in the code.
So am sending this message to ask you, if some of you have ideas about
features or improvement and you want one more for help.
Also if you have some issues you want some help please let me know (jira
account chrikon).
Thanks in advance,
Regards
Christos
On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <ch...@gmail.com>
wrote:
> Sorry Hadrian thank you for your correction, this will not happen again!
>
> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <hz...@gmail.com>
> wrote:
>
>> Hi Christos,
>>
>> First off, I am not a Mister :), just Hadrian.
>>
>> Yes, the idea is to collaborate, that's what open source is about.
>>
>> Good luck,
>> Hadrian
>>
>>
>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
>>
>>> Firstly thank you all for your suggestions, all of them are very helpful.
>>>
>>> In this moment I follow the very good advice and I am reading
>>> documentation, because next Wednesday I have to make a presentation for
>>> tinkerpop in front of my class!
>>>
>>> Marko I have to write code for my assignment, but in my free time it is
>>> an
>>> interesting work.
>>>
>>> Although Javadoc it is applicable to my assignment, I think. I will ask
>>> and
>>> I will have news.
>>>
>>> If Mr. Hadrian Zbarcea are working on it, I would like not to interfere
>>> in
>>> your job, or we can cooperate.
>>> Before that discussion I have to contact to my academic supervisor in
>>> order
>>> to be 100% sure that this is ok.
>>>
>>> P.S. I hope my English is at least understandable, if not so please ask
>>> me
>>> again.
>>>
>>> Thank you all.
>>> Christos
>>>
>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <hz...@gmail.com>
>>> wrote:
>>>
>>> That's something I am interested in too.
>>>> Hadrian
>>>>
>>>>
>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
>>>>
>>>> Hi Christos,
>>>>>
>>>>> Another thing that we need is more JavaDoc! Its not sexy, but boy would
>>>>> be it be great to have someone go through and JavaDoc-up GraphTraversal
>>>>> (all those methods…).
>>>>>
>>>>> https://github.com/apache/incubator-tinkerpop/blob/
>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
>>>>>
>>>>> …the docs provide a description of each step.
>>>>>
>>>>> http://tinkerpop.incubator.apache.org/docs/3.0.0-
>>>>> SNAPSHOT/#traversal (see the TOC for direct clicking to any particular
>>>>> step)
>>>>>
>>>>> I would say that would be more helpful now than a "Through the
>>>>> TinkerPop"-tutorial.
>>>>>
>>>>> Finally, what else would be helpful --- more test cases. If you are
>>>>> interested in testing, I can get your set up in with "a pattern" so
>>>>> you pop
>>>>> out more process/ tests. For example:
>>>>>
>>>>> https://github.com/apache/incubator-tinkerpop/blob/
>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
>>>>> gremlin/process/traversal/step/map/CountTest.java
>>>>>
>>>>> Thanks,
>>>>> Marko.
>>>>>
>>>>> http://markorodriguez.com
>>>>>
>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <ok...@gmail.com>
>>>>> wrote:
>>>>>
>>>>> Hi Christos,
>>>>>
>>>>>>
>>>>>> Are you interested in writing code or perhaps, writing a tutorial?
>>>>>>
>>>>>> It would be nice to have an in-depth tutorial on TinkerPop3. For
>>>>>> instance, find a reasonably sized dataset (<1 million edges), parse
>>>>>> it into
>>>>>> a graph, do some analysis on it, expose it via Gremlin Server, OLTP
>>>>>> and
>>>>>> OLAP queries hitting it, etc. Write up the path you took into an
>>>>>> AsciiDoc
>>>>>> and we could put it on the Apache TinkerPop site as a "Through the
>>>>>> TinkerPop" tutorial. Be great if you could touch on every aspect of
>>>>>> the
>>>>>> TinkerPop framework in the tutorial.
>>>>>>
>>>>>> I would appreciate a contribution like that.
>>>>>>
>>>>>> Thanks,
>>>>>> Marko.
>>>>>>
>>>>>> http://markorodriguez.com
>>>>>>
>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <m....@gmail.com>
>>>>>> wrote:
>>>>>>
>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen Mallette <
>>>>>> spmallette@gmail.com>
>>>>>>
>>>>>>> wrote:
>>>>>>>
>>>>>>> My suggestion would be for you to spend some time learning about
>>>>>>>
>>>>>>>> TinkerPop
>>>>>>>> (reading the documentation, examining the code base, perusing the
>>>>>>>> Jira
>>>>>>>> issue tracker, etc.) to determine if any particular part of the
>>>>>>>> stack
>>>>>>>> interests you.
>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>> IMO, there is no better way to get involved than to pick something
>>>>>>> that
>>>>>>> needs to be worked on and provide a patch for it. I would look at
>>>>>>> JIRA
>>>>>>> and
>>>>>>> find an issue that interests you.
>>>>>>>
>>>>>>>
>>>>>>> In doing that, you might develop your own ideas as to
>>>>>>>
>>>>>>>> where/what you think you are best suited to contribute. At that
>>>>>>>> point
>>>>>>>> you
>>>>>>>> could post those ideas here in the mailing list for feedback.
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos Oikonomou <
>>>>>>>> chrikon1994@gmail.com
>>>>>>>>
>>>>>>>>
>>>>>>>>> wrote:
>>>>>>>>>
>>>>>>>>
>>>>>>>> Hi Stephen
>>>>>>>>
>>>>>>>>> When I start I was not familiar with the project nor the
>>>>>>>>> architecture/codebase.
>>>>>>>>> But I am reading about tinkerpop and searching in the code and
>>>>>>>>> I am thinking to make some simple examples in order to be more
>>>>>>>>> familiar
>>>>>>>>> with the functionality.
>>>>>>>>> So I am not now very familiar but I try to be in the near future.
>>>>>>>>>
>>>>>>>>> Christos
>>>>>>>>>
>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen Mallette <
>>>>>>>>> spmallette@gmail.com>
>>>>>>>>> wrote:
>>>>>>>>>
>>>>>>>>> Hi Christos, we appreciate your offer to contribute. Could you
>>>>>>>>> tell
>>>>>>>>>
>>>>>>>>>> us
>>>>>>>>>> what kind of experience you have with TinkerPop so far? Are you
>>>>>>>>>> at
>>>>>>>>>> all
>>>>>>>>>> familiar with the architecture/codebase?
>>>>>>>>>>
>>>>>>>>>> Stephen
>>>>>>>>>>
>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos Oikonomou <
>>>>>>>>>> chrikon1994@gmail.com>
>>>>>>>>>> wrote:
>>>>>>>>>>
>>>>>>>>>> Dear Tinkerpop Development Team
>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>> My name is Christos Economou.
>>>>>>>>>>>
>>>>>>>>>>> I would like to contribute in the tinkerpop3.
>>>>>>>>>>> This contribution will be a part of an assignment in one of my
>>>>>>>>>>>
>>>>>>>>>>> classes.
>>>>>>>>>>
>>>>>>>>>
>>>>>>>>
>>>>>>>>> I am in my third year of study at Athens University of Economics
>>>>>>>>>>> and
>>>>>>>>>>> Business (Greece | Hellas).In this semester I attend in lectures
>>>>>>>>>>> that
>>>>>>>>>>> called "Advanced Topics in Software Engineering" by professor
>>>>>>>>>>>
>>>>>>>>>>> Diomidis
>>>>>>>>>>
>>>>>>>>>
>>>>>>>> Spinellis.
>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>> As assignment I have to contribute in an open source project. I
>>>>>>>>>>> would
>>>>>>>>>>> prefer to contribute to tinkerpop3. More specifically I
>>>>>>>>>>> understand
>>>>>>>>>>>
>>>>>>>>>>> that
>>>>>>>>>>
>>>>>>>>>
>>>>>>>> in
>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>> big projects, like this, always exists work on integration and
>>>>>>>>>>> collaboration between components and subsystems. So I do not have
>>>>>>>>>>> any
>>>>>>>>>>> problem to work on that. But I am more interested in creative
>>>>>>>>>>> work
>>>>>>>>>>>
>>>>>>>>>>> like
>>>>>>>>>>
>>>>>>>>>
>>>>>>>> implementation of some algorithm or on a new functionality.
>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>> I have to mention I have a hard constraint, that my contribution
>>>>>>>>>>>
>>>>>>>>>>> should
>>>>>>>>>>
>>>>>>>>>
>>>>>>>> be
>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>> at least 100 - 200 lines of code.
>>>>>>>>>>>
>>>>>>>>>>> So I am writing you to ask if you have in mind some
>>>>>>>>>>> functionalities
>>>>>>>>>>>
>>>>>>>>>>> that
>>>>>>>>>>
>>>>>>>>>
>>>>>>>>> I
>>>>>>>>>>
>>>>>>>>>> can help in development. Here some information about my
>>>>>>>>>>> knowledge in
>>>>>>>>>>> software engineering and programming languages
>>>>>>>>>>>
>>>>>>>>>>> http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
>>>>>>>>>>>
>>>>>>>>>> inetpub/detfolio/.
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>> Thank you for your time and attention.
>>>>>>>>>>>
>>>>>>>>>>> Regards,
>>>>>>>>>>> Christos Oikonomou
>>>>>>>>>>> Assistant researcher at ISTLab
>>>>>>>>>>> http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
>>>>>>>>>>> Github: https://github.com/xristosoik
>>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>
>>>>>>>>
>>>>>>
>>>>>
>>>>>
>>>
>
Re: Contributing to tinkerpop3
Posted by ch...@gmail.com.
Thanks for the feedback!
I will work on the import of your ideas in my code!
I am glade that it was not so bad first approach!
About the integration testing I agree! This will be more safe if I implements donee of those!
I will be in touch with you for the improvements in order my code to be accepted eventually in tinkerpop!
Regards
Christos
Στάλθηκε από το iPhone μου
10 Ιουν 2015, 3:38 μ.μ., ο/η Stephen Mallette <sp...@gmail.com> έγραψε:
> Hi Christos, I had some time to look at your work in more detail. Again,
> this looks like a great feature - thanks for putting the time into building
> this.
>
> I like Marko's feedback especially the part about about streamlining the
> multiple commands into a single command. I think that will make the
> command naming space a bit more tidy. At the moment, I'm not sure that I
> have much more functional feedback - I focused more time on the code itself.
>
> It looks like you didn't have any real problems learning the structure and
> patterns of the Console. It's good to see that you were able to learn that
> stuff as there isn't really any documentation on it.
>
> First and primary issue...this method implementation jumped out at me:
>
> https://github.com/apache/incubator-tinkerpop/pull/71/files#diff-32e4c25b70c7a840a202312f4cc82ccfR54
>
> If i'm not mistaken that's a really important piece of code as it is
> responsible for finding methods in the HTML. The issue I'm worried about
> is that it seems a bit brittle to me, as you are parsing raw HTML directly
> and looping through it with low-level reader functions. IMHO, that makes
> the code hard for an outsider to follow without really digging into it to
> understand what's going on. I think you're also relying on HTML comments
> to find positions in the javadoc and other cues that might not be reliable
> (that's just a guess as i don't fully know the internals of the javadoc
> generator super well, but it makes me wonder how easily this will crack if
> we ever updated the maven javadoc plugin).
>
> given that you are using groovy, i wonder if you couldn't have used the
> XmlSlurper to read the HTML. it can actually make parsing HTML/XML quite
> enjoyable actually. Your code for finding method names then simplifies to
> something like this (didn't test this code, but it's pretty close):
>
> def html = new XmlSlurper().parseText(javadocHtmlString)
> html."**".findAll { it.@class.toString().equals("memberNameLink")}.each {
> def methodName = it.a[0].text()
> def methodUri = it.a[0].@href.text()
> }
>
> That's a lot less code to maintain and is easily readable by someone who is
> taking a first look at what's going on with your document feature. The
> only problem I can imagine is if the XmlSlurper gets annoyed by the HTML
> that javadoc produces. In any case, it is worth a shot.
>
> As separate issue, I see that you have some unit tests in place. It would
> be nice to see more of those especially around parsing and perhaps even
> some integration tests with the console itself. I can provide more
> specific feedback in this area after you dig into the issues that have
> already be raised to you.
>
> Thanks again for this body of work. I really think it will shape into a
> nice feature that will help users in a big way.
>
> Stephen
>
>
>
>
> On Mon, Jun 8, 2015 at 11:57 AM, Marko Rodriguez <ok...@gmail.com>
> wrote:
>
>> Hi Christos,
>>
>> First off, this is a very cool feature. Nice idea and great contribution
>> -- and really cool of you to provide the screenshot as that makes things
>> easy to grok (
>> https://cloud.githubusercontent.com/assets/5932880/8024819/4b571542-0d49-11e5-87f9-f7ac5439b6e5.png).
>> Next, here are my thoughts on your implementation. Note that I have not
>> looked at your code, just the description/screenshot of what you provided
>> in your PR.
>>
>> You have:
>>
>> // This is a command for loading of the documentation of a Class*.
>> gremlin> :importdocs "Graph"
>> //This is a command for displaying the documentation of a method**.
>> gremlin> :docs "addVertex"
>> //This id a command who returns the current loaded Class.
>> gremlin> :currdocs
>>
>> 1. Auto-Import
>> I think we should have a class like ImportCustomizerProvider which
>> specifies which classes to have their docs loaded. This way, users don't
>> have to do all these imports.
>>
>> https://github.com/apache/incubator-tinkerpop/blob/master/gremlin-groovy/src/main/java/org/apache/tinkerpop/gremlin/groovy/AbstractImportCustomizerProvider.java#L69
>> In fact, if we can just use the classes in ImportCustomizerProvider, that
>> would reduce the number of classes to maintain. Also note that we have this
>> in our pom.xml to generate the "core" JavaDoc:
>>
>> https://github.com/apache/incubator-tinkerpop/blob/master/pom.xml#L750-L812
>> Perhaps you could just auto-include those classes in the "core" JavaDoc
>> specification.
>>
>> http://tinkerpop.incubator.apache.org/javadocs/3.0.0-SNAPSHOT/core/
>>
>> 2. Class Disambiguation
>> Next, given the above, you may have the same method for two different
>> classes. As such, I think your :docs command should be:
>> :docs Graph.addVertex
>>
>> 3. Command Naming
>> I don't think we should have multiple : commands for the same feature. We
>> should leverage the second argument as the parameterization of the command.
>> I think it should be:
>> :javadocs import Graph
>> // or :javadocs import com.company.tinkerpop.MyPredicate
>> if the class is not imported or on disambiguation
>> :javadocs view Graph.addVertex
>> :javadocs list
>>
>> I'm not married to ":javadocs" though I don't think it should be ":docs"
>> as we use that in our scheme for the AsciiDocs.
>>
>> http://tinkerpop.incubator.apache.org/javadocs/3.0.0-SNAPSHOT/core/
>>
>> http://tinkerpop.incubator.apache.org/javadocs/3.0.0-SNAPSHOT/full/
>> http://tinkerpop.incubator.apache.org/docs/3.0.0-SNAPSHOT/
>>
>> 4. System.out.println Look-and-Feel
>> I think the outputted String should be of the form:
>>
>> ===============
>> Graph.addVertex
>> ===============
>> Vertex addVertex(Object… keyValues)
>>
>> The description of the method just like you have it now.
>>
>> Parameters:
>> keyValues - the key/values pairs to turn into vertex properties
>> Returns:
>> The newly created vertex
>>
>> The changes being:
>>
>> 1. Include the class name in the ===== section.
>> 2. The parameters should not have an extra \n but instead, just \t
>> indent to make it more compact looking. (or 2-3 spaces instead of \t if \t
>> looks weird)
>> 3. The return should not have an extra \n but instead, just \t
>> indent to make it more compact looking.
>> 4. No extra \n at the end before going back to gremlin>.
>>
>> Thanks Christos,
>> Marko.
>>
>> http://markorodriguez.com
>>
>>> On Jun 8, 2015, at 5:26 AM, Stephen Mallette <sp...@gmail.com> wrote:
>>>
>>> The screenshot you provided on the PR looks pretty cool! We'll take a
>> look
>>> at it in more detail...thanks.
>>>
>>> On Mon, Jun 8, 2015 at 4:51 AM, Christos Oikonomou <
>> chrikon1994@gmail.com>
>>> wrote:
>>>
>>>> Hello everyone,
>>>>
>>>> I have finished my work on commands and I have done a pull request
>>>> yesterday!
>>>> (The checking with travis BI will be done when my request is overviewed
>> for
>>>> the pull request or I should do it myself?)
>>>>
>>>> If you have some time review my submission for feedback and corrections.
>>>>
>>>> Thank you for your time anyway
>>>>
>>>> Regards,
>>>> Christos
>>>>
>>>> On Tue, May 26, 2015 at 6:14 PM, Stephen Mallette <spmallette@gmail.com
>>>
>>>> wrote:
>>>>
>>>>> I'd forgotten that we package the javadoc with the zip. I think that
>>>> makes
>>>>> sense. Feel free to share the link to your fork (and more information
>>>>> about your design, like how the commands work) when you are ready,
>>>> however
>>>>> the earlier you get feedback the more helpful it might be to you.
>>>>>
>>>>> On Tue, May 26, 2015 at 10:05 AM, Christos Oikonomou <
>>>>> chrikon1994@gmail.com>
>>>>> wrote:
>>>>>
>>>>>> Hello Stephen,
>>>>>> I thought that it would be better to avoid reading url if we provide
>>>> the
>>>>>> .html in the release zip.
>>>>>> That's why I thought to create two methods to read the javadocs
>> locally
>>>>>> (why I need the path) or if that fails to go to url. I f you believe
>>>> that
>>>>>> is not necessary this works fine for me also because it is a lot of
>>>> work.
>>>>>> But this operation will not work off line.
>>>>>> For the repo yes I have one folk but I have not finnish all the
>>>>>> documentation and junit so I have not push yet, when I do I will send
>>>> you
>>>>>> the link.
>>>>>> Regards,
>>>>>> Christos
>>>>>>
>>>>>> On Tue, May 26, 2015 at 2:44 PM, Stephen Mallette <
>>>> spmallette@gmail.com>
>>>>>> wrote:
>>>>>>
>>>>>>> Hi Christos - I assume that you have a fork of TinkerPop3 somewhere?
>>>>>>> Perhaps you could point us to your code so that we can see what
>>>> you've
>>>>>>> done? It might be easier to discuss if we could see that. Also, it
>>>>>> would
>>>>>>> be helpful to know more about your proposed syntax to your commands
>>>> and
>>>>>>> what they will do.
>>>>>>>
>>>>>>>> Secondly what is the correct path for the javadoc in release and in
>>>>>>> development
>>>>>>> version?
>>>>>>>
>>>>>>> We deploy javadocs for every official release and for the current
>>>>>>> SNAPSHOT. The Console can find the current version by calling
>>>>>>> Gremlin.version() - you should be able to use that to construct the
>>>>> right
>>>>>>> URL to the javadoc. I think that would work.
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> On Mon, May 25, 2015 at 9:15 AM, Christos Oikonomou <
>>>>>> chrikon1994@gmail.com
>>>>>>> wrote:
>>>>>>>
>>>>>>>> Hello everyone
>>>>>>>>
>>>>>>>> I was working on Java displaying in gremlin console.
>>>>>>>> I have came to a point that I need your guidance.
>>>>>>>> I have made 3 classes one for importing, for Doc structure in a
>>>> class
>>>>>> and
>>>>>>>> third for the structure of the data in a method.
>>>>>>>>
>>>>>>>> Also I add 2 commands in groovy the ImportDocsCommand and
>>>>> DicsCommand.
>>>>>>> The
>>>>>>>> first impliment the import of the javadocs of a class for the
>>>>>> Class.html
>>>>>>>> and the second the displaying.
>>>>>>>>
>>>>>>>> Firstly what are your thoughts for those,
>>>>>>>>
>>>>>>>> Secondly what is the correct path for the javadoc in release and in
>>>>>>>> development version?
>>>>>>>>
>>>>>>>> Regards
>>>>>>>> Christos
>>>>>>>>
>>>>>>>> On Sat, Apr 25, 2015 at 2:59 PM, Christos Oikonomou <
>>>>>>> chrikon1994@gmail.com
>>>>>>>> wrote:
>>>>>>>>
>>>>>>>>> I thought we can create an doc.xml with all the relative
>>>>> information
>>>>>>>>> gathered for every function.
>>>>>>>>>
>>>>>>>>> Although I see your point.
>>>>>>>>>
>>>>>>>>> But I like also the idea of Matt.....
>>>>>>>>>
>>>>>>>>> As I see this was something that interest you so I will start
>>>>> working
>>>>>>> on
>>>>>>>>> how that should be implemented.
>>>>>>>>>
>>>>>>>>> Regards,
>>>>>>>>> Christos
>>>>>>>>>
>>>>>>>>> On Sat, Apr 25, 2015 at 1:35 PM, Stephen Mallette <
>>>>>>> spmallette@gmail.com>
>>>>>>>>> wrote:
>>>>>>>>>
>>>>>>>>>> Matt, I like idea for a :docimport command. By default we would
>>>>>> load
>>>>>>>>>> GraphTraversal into it so that
>>>>>>>>>>
>>>>>>>>>> gremlin> :doc outE
>>>>>>>>>>
>>>>>>>>>> could resolve to the appropriate javadoc right out the box. It
>>>> is
>>>>>>>>>> generally applicable and as you say might even be of interest to
>>>>> the
>>>>>>>>>> groovy
>>>>>>>>>> project at some point.
>>>>>>>>>>
>>>>>>>>>> Christos, I think the categories you mention are good, but I
>>>> would
>>>>>>> take
>>>>>>>>>> care to consider the source of the documentation. Where would
>>>>> those
>>>>>>>>>> categories come from for you to display them? I don't think it
>>>>> would
>>>>>>> be
>>>>>>>>>> especially helpful if we had to manage javadoc, the asciidoc and
>>>>>> then
>>>>>>>>>> another class of documentation for the console. I think that
>>>>>>>> re-purposing
>>>>>>>>>> the javadoc is the best approach here and if we write some good
>>>>>>> javadoc
>>>>>>>> we
>>>>>>>>>> will roughly cover your categories. You could obviously display
>>>>> the
>>>>>>>> text
>>>>>>>>>> of the javadoc, which would likely cover your first two
>>>> categories
>>>>>> (if
>>>>>>>>>> written well). For the links, we could add @see tags as needed
>>>> to
>>>>>> the
>>>>>>>>>> javadoc and those would be the links to display in the console.
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>> On Fri, Apr 24, 2015 at 7:13 PM, Christos Oikonomou <
>>>>>>>>>> chrikon1994@gmail.com>
>>>>>>>>>> wrote:
>>>>>>>>>>
>>>>>>>>>>> I am glad for your reaction.
>>>>>>>>>>> I was thinking that we can display the information in 4
>>>>> categories
>>>>>>>>>>>
>>>>>>>>>>> gremlin> :doc foo
>>>>>>>>>>> Description of Functionality
>>>>>>>>>>> .....
>>>>>>>>>>> Some relevant functionalities
>>>>>>>>>>> ......
>>>>>>>>>>> Link to the user documentation
>>>>>>>>>>> ......
>>>>>>>>>>> Link to the javadoc
>>>>>>>>>>> .........
>>>>>>>>>>>
>>>>>>>>>>> Do you believe that informations will be clear to all kinds of
>>>>>> users
>>>>>>>>>>>
>>>>>>>>>>> On Sat, Apr 25, 2015 at 12:36 AM, Matt Frantz <
>>>>>>>>>> matthew.h.frantz@gmail.com>
>>>>>>>>>>> wrote:
>>>>>>>>>>>
>>>>>>>>>>>> Perhaps there should be a command to import the javadocs
>>>> for a
>>>>>>>>>> particular
>>>>>>>>>>>> package or interface, e.g. a DSL interface. The effect
>>>> would
>>>>> be
>>>>>>> to
>>>>>>>>>> haul
>>>>>>>>>>>> the methods into the global doc namespace. By default, we
>>>>> would
>>>>>>>> apply
>>>>>>>>>>> that
>>>>>>>>>>>> to GraphTraversal.
>>>>>>>>>>>>
>>>>>>>>>>>> gremlin> :doc outE
>>>>>>>>>>>> TODO: Write a good javadoc for each GraphTraversal method
>>>>>>>>>>>> gremlin> :importdoc TinkerFactory.SocialTraversal
>>>>>>>>>>>> gremlin> :doc people
>>>>>>>>>>>> TODO: Write a good javadoc for each SocialTraversal method
>>>>>>>>>>>>
>>>>>>>>>>>> It could be applied to any class or interface. Applying it
>>>>> to a
>>>>>>>>>> package
>>>>>>>>>>>> would haul the classes and subpackages into the global doc
>>>>>>>> namespace.
>>>>>>>>>>>>
>>>>>>>>>>>> gremlin> :importdoc
>>>>>>>> org.apache.tinkerpop.gremlin.tinkergraph.structure
>>>>>>>>>>>> gremlin> :doc TinkerHelper
>>>>>>>>>>>> gremlin> :doc TinkerHelper.queryVertexIndex
>>>>>>>>>>>>
>>>>>>>>>>>> Maybe you could allow fully-qualified resolution without an
>>>>>>> import:
>>>>>>>>>>>>
>>>>>>>>>>>> gremlin> :doc
>> org.apache.tinkerpop.gremlin.tinkergraph.structure.TinkerHelper.queryVertexIndex
>>>>>>>>>>>>
>>>>>>>>>>>> This seems like something that could be contributed upstream
>>>>> to
>>>>>>> the
>>>>>>>>>>> Groovy
>>>>>>>>>>>> REPL.
>>>>>>>>>>>>
>>>>>>>>>>>> On Fri, Apr 24, 2015 at 12:10 PM, Stephen Mallette <
>>>>>>>>>> spmallette@gmail.com
>>>>>>>>>>>>
>>>>>>>>>>>> wrote:
>>>>>>>>>>>>
>>>>>>>>>>>>> Yeah - it would be straightforward to bring in javadoc for
>>>>> the
>>>>>>>> most
>>>>>>>>>>> part:
>>>>>>>>>>>>>
>>>>>>>>>>>>> gremlin> :doc EdgeVertexStep
>>>>>>>>>>>>>
>>>>>>>>>>>>> you can get the class from that and full package name with
>>>>>>>>>> reflection
>>>>>>>>>>>> then
>>>>>>>>>>>>> translate it to javadoc to extract some text to display in
>>>>> the
>>>>>>>>>> console.
>>>>>>>>>>>> I
>>>>>>>>>>>>> guess that's nice, but no one knows VertexStep. They know
>>>>>> this
>>>>>>>> step
>>>>>>>>>>>>> though:
>>>>>>>>>>>>>
>>>>>>>>>>>>> gremlin> :doc outE
>>>>>>>>>>>>>
>>>>>>>>>>>>> So - I guess the question is how one would go from just a
>>>>> pure
>>>>>>>>>> javadoc
>>>>>>>>>>>>> lookup command (cool but a bit less useful to a first time
>>>>>> user
>>>>>>>> who
>>>>>>>>>>>> doesn't
>>>>>>>>>>>>> know the classes - not that EdgeVertexStep would yield
>>>>>> anything
>>>>>>>>>> about
>>>>>>>>>>>> outE
>>>>>>>>>>>>> for that matter as it sits) to something that gives the
>>>> user
>>>>>>>>>> content on
>>>>>>>>>>>>> steps from GraphTraversal which is the core of the DSL.
>>>> And
>>>>>>> then
>>>>>>>> -
>>>>>>>>>> how
>>>>>>>>>>>>> would it extend to other DSLs so that it was generally
>>>>>>> applicable
>>>>>>>> to
>>>>>>>>>>>> those
>>>>>>>>>>>>> extending the language.
>>>>>>>>>>>>>
>>>>>>>>>>>>>
>>>>>>>>>>>>>
>>>>>>>>>>>>> On Fri, Apr 24, 2015 at 3:02 PM, Marko Rodriguez <
>>>>>>>>>> okrammarko@gmail.com
>>>>>>>>>>>>
>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>
>>>>>>>>>>>>>> That would be really classy. It would be cool if that
>>>>> could
>>>>>> be
>>>>>>>>>> read
>>>>>>>>>>>> from
>>>>>>>>>>>>>> the JavaDoc somehow………… then we kill two birds with one
>>>>>> stone.
>>>>>>>>>>>>>>
>>>>>>>>>>>>>> Marko.
>>>>>>>>>>>>>>
>>>>>>>>>>>>>> http://markorodriguez.com
>>>>>>>>>>>>>>
>>>>>>>>>>>>>> On Apr 24, 2015, at 12:08 PM, Stephen Mallette <
>>>>>>>>>> spmallette@gmail.com
>>>>>>>>>>>>
>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> A gremlin-command that display in gremlin-console
>>>> user
>>>>>>>>>>> documentation
>>>>>>>>>>>>> or
>>>>>>>>>>>>>>> javadocs of a gremlin functionality could be something
>>>>>> that
>>>>>>>>>> helps
>>>>>>>>>>>> user?
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> That's an interesting idea. I assume you are
>>>> suggesting
>>>>>>>>>> something
>>>>>>>>>>>>> like:
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> gremlin> :doc choose
>>>>>>>>>>>>>>> ==>The choose()-step (branch) routes the current
>>>>> traverser
>>>>>>> to
>>>>>>>> a
>>>>>>>>>>>>>> particular
>>>>>>>>>>>>>>> traversal branch option. With choose(), it is possible
>>>>> to
>>>>>>>>>>>>> implement......
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> Is that what you mean?
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <
>>>>>>>>>>>>>> chrikon1994@gmail.com>
>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> Hello and sorry for the delay. Thanks for the
>>>> answers.
>>>>>>>>>>>>>>>> I have done a general overview of all the code base.
>>>>> But
>>>>>>> more
>>>>>>>>>>>>>> familiarized
>>>>>>>>>>>>>>>> I am in gremlin-core and gremlin-console.
>>>>>>>>>>>>>>>> I prefer the assignment of issues because I wants to
>>>>> help
>>>>>>>> also
>>>>>>>>>> to
>>>>>>>>>>>> the
>>>>>>>>>>>>>>>> faster achievement of the project planning in
>>>> general.
>>>>>>>>>>>>>>>> Also I have an idea in documentation. A
>>>> gremlin-command
>>>>>>> that
>>>>>>>>>>> display
>>>>>>>>>>>>> in
>>>>>>>>>>>>>>>> gremlin-console user documentation or javadocs of a
>>>>>> gremlin
>>>>>>>>>>>>>> functionality
>>>>>>>>>>>>>>>> could be something that helps user?
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> Regards,
>>>>>>>>>>>>>>>> Christos
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <
>>>>>>>>>>>>>> m.ben.franklin@gmail.com>
>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <
>>>>>>>>>>>>> okrammarko@gmail.com>
>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>> Hi Christos,
>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>> Given that you have familiarized yourself with the
>>>>>>>> codebase,
>>>>>>>>>>> which
>>>>>>>>>>>>>> area
>>>>>>>>>>>>>>>>> of
>>>>>>>>>>>>>>>>>> the codebase do you feel:
>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>> 1. you understand the best, and
>>>>>>>>>>>>>>>>>> 2. are interested in working on.
>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>> Given that information, I will be able to figure
>>>> out
>>>>>>>>>> something
>>>>>>>>>>>>>>>> particular
>>>>>>>>>>>>>>>>>> for you to do.
>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>> You should also feel free to pick an issue off of
>>>> JIRA
>>>>>>>>>> yourself,
>>>>>>>>>>> or
>>>>>>>>>>>>>> even
>>>>>>>>>>>>>>>>> create an issue and submit a patch for it.
>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>> Thanks,
>>>>>>>>>>>>>>>>>> Marko.
>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>> http://markorodriguez.com
>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
>>>>>>>>>>>>>>>> chrikon1994@gmail.com>
>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>> Hello everyone,
>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>> I have read your advices how to start and how to
>>>> be
>>>>>>>>>>> familiarized
>>>>>>>>>>>>> with
>>>>>>>>>>>>>>>>> the
>>>>>>>>>>>>>>>>>>> codebase. After some time I spent exploring the
>>>>> code,
>>>>>> I
>>>>>>>>>>> believe I
>>>>>>>>>>>>> am
>>>>>>>>>>>>>>>>>> ready
>>>>>>>>>>>>>>>>>>> to start specific changes in the code.
>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>> So am sending this message to ask you, if some of
>>>>> you
>>>>>>> have
>>>>>>>>>>> ideas
>>>>>>>>>>>>>>>> about
>>>>>>>>>>>>>>>>>>> features or improvement and you want one more for
>>>>>> help.
>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>> Also if you have some issues you want some help
>>>>> please
>>>>>>> let
>>>>>>>>>> me
>>>>>>>>>>>> know
>>>>>>>>>>>>>>>>> (jira
>>>>>>>>>>>>>>>>>>> account chrikon).
>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>> Thanks in advance,
>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>> Regards
>>>>>>>>>>>>>>>>>>> Christos
>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos
>>>> Oikonomou
>>>>> <
>>>>>>>>>>>>>>>>>> chrikon1994@gmail.com>
>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>> Sorry Hadrian thank you for your correction, this
>>>>>> will
>>>>>>>> not
>>>>>>>>>>>> happen
>>>>>>>>>>>>>>>>> again!
>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea
>>>> <
>>>>>>>>>>>>>>>> hzbarcea@gmail.com>
>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>> Hi Christos,
>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>> First off, I am not a Mister :), just Hadrian.
>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>> Yes, the idea is to collaborate, that's what
>>>> open
>>>>>>> source
>>>>>>>>>> is
>>>>>>>>>>>>> about.
>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>> Good luck,
>>>>>>>>>>>>>>>>>>>>> Hadrian
>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou
>>>> wrote:
>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> Firstly thank you all for your suggestions, all
>>>>> of
>>>>>>> them
>>>>>>>>>> are
>>>>>>>>>>>> very
>>>>>>>>>>>>>>>>>> helpful.
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> In this moment I follow the very good advice
>>>> and
>>>>> I
>>>>>> am
>>>>>>>>>>> reading
>>>>>>>>>>>>>>>>>>>>>> documentation, because next Wednesday I have to
>>>>>> make
>>>>>>> a
>>>>>>>>>>>>>>>> presentation
>>>>>>>>>>>>>>>>>> for
>>>>>>>>>>>>>>>>>>>>>> tinkerpop in front of my class!
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> Marko I have to write code for my assignment,
>>>> but
>>>>>> in
>>>>>>> my
>>>>>>>>>> free
>>>>>>>>>>>>> time
>>>>>>>>>>>>>>>> it
>>>>>>>>>>>>>>>>>> is
>>>>>>>>>>>>>>>>>>>>>> an
>>>>>>>>>>>>>>>>>>>>>> interesting work.
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> Although Javadoc it is applicable to my
>>>>>> assignment, I
>>>>>>>>>>> think. I
>>>>>>>>>>>>>>>> will
>>>>>>>>>>>>>>>>>> ask
>>>>>>>>>>>>>>>>>>>>>> and
>>>>>>>>>>>>>>>>>>>>>> I will have news.
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> If Mr. Hadrian Zbarcea are working on it, I
>>>> would
>>>>>>> like
>>>>>>>>>> not
>>>>>>>>>>> to
>>>>>>>>>>>>>>>>>> interfere
>>>>>>>>>>>>>>>>>>>>>> in
>>>>>>>>>>>>>>>>>>>>>> your job, or we can cooperate.
>>>>>>>>>>>>>>>>>>>>>> Before that discussion I have to contact to my
>>>>>>> academic
>>>>>>>>>>>>> supervisor
>>>>>>>>>>>>>>>>> in
>>>>>>>>>>>>>>>>>>>>>> order
>>>>>>>>>>>>>>>>>>>>>> to be 100% sure that this is ok.
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> P.S. I hope my English is at least
>>>>> understandable,
>>>>>> if
>>>>>>>>>> not so
>>>>>>>>>>>>>>>> please
>>>>>>>>>>>>>>>>>> ask
>>>>>>>>>>>>>>>>>>>>>> me
>>>>>>>>>>>>>>>>>>>>>> again.
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> Thank you all.
>>>>>>>>>>>>>>>>>>>>>> Christos
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian
>>>> Zbarcea
>>>>> <
>>>>>>>>>>>>>>>>> hzbarcea@gmail.com>
>>>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> That's something I am interested in too.
>>>>>>>>>>>>>>>>>>>>>>> Hadrian
>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>> Hi Christos,
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>> Another thing that we need is more JavaDoc!
>>>> Its
>>>>>> not
>>>>>>>>>> sexy,
>>>>>>>>>>>> but
>>>>>>>>>>>>>>>> boy
>>>>>>>>>>>>>>>>>> would
>>>>>>>>>>>>>>>>>>>>>>>> be it be great to have someone go through and
>>>>>>>>>> JavaDoc-up
>>>>>>>>>>>>>>>>>> GraphTraversal
>>>>>>>>>>>>>>>>>>>>>>>> (all those methods…).
>>>>>>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
>>>>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
>>>>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>> …the docs provide a description of each step.
>>>>>>>>>> http://tinkerpop.incubator.apache.org/docs/3.0.0-
>>>>>>>>>>>>>>>>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct
>>>>>>> clicking
>>>>>>>> to
>>>>>>>>>>> any
>>>>>>>>>>>>>>>>>> particular
>>>>>>>>>>>>>>>>>>>>>>>> step)
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>> I would say that would be more helpful now
>>>>> than a
>>>>>>>>>> "Through
>>>>>>>>>>>> the
>>>>>>>>>>>>>>>>>>>>>>>> TinkerPop"-tutorial.
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>> Finally, what else would be helpful --- more
>>>>> test
>>>>>>>>>> cases.
>>>>>>>>>>> If
>>>>>>>>>>>>> you
>>>>>>>>>>>>>>>>> are
>>>>>>>>>>>>>>>>>>>>>>>> interested in testing, I can get your set up
>>>> in
>>>>>>> with
>>>>>>>> "a
>>>>>>>>>>>>> pattern"
>>>>>>>>>>>>>>>>> so
>>>>>>>>>>>>>>>>>>>>>>>> you pop
>>>>>>>>>>>>>>>>>>>>>>>> out more process/ tests. For example:
>>>>>>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
>>>>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
>>>>> gremlin/process/traversal/step/map/CountTest.java
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>> Thanks,
>>>>>>>>>>>>>>>>>>>>>>>> Marko.
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>> http://markorodriguez.com
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez
>>>> <
>>>>>>>>>>>>>>>>> okrammarko@gmail.com>
>>>>>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>> Hi Christos,
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> Are you interested in writing code or
>>>> perhaps,
>>>>>>>>>> writing a
>>>>>>>>>>>>>>>>> tutorial?
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> It would be nice to have an in-depth
>>>> tutorial
>>>>> on
>>>>>>>>>>>> TinkerPop3.
>>>>>>>>>>>>>>>> For
>>>>>>>>>>>>>>>>>>>>>>>>> instance, find a reasonably sized dataset
>>>> (<1
>>>>>>>> million
>>>>>>>>>>>> edges),
>>>>>>>>>>>>>>>>> parse
>>>>>>>>>>>>>>>>>>>>>>>>> it into
>>>>>>>>>>>>>>>>>>>>>>>>> a graph, do some analysis on it, expose it
>>>> via
>>>>>>>> Gremlin
>>>>>>>>>>>>> Server,
>>>>>>>>>>>>>>>>> OLTP
>>>>>>>>>>>>>>>>>>>>>>>>> and
>>>>>>>>>>>>>>>>>>>>>>>>> OLAP queries hitting it, etc. Write up the
>>>>> path
>>>>>>> you
>>>>>>>>>> took
>>>>>>>>>>>> into
>>>>>>>>>>>>>>>> an
>>>>>>>>>>>>>>>>>>>>>>>>> AsciiDoc
>>>>>>>>>>>>>>>>>>>>>>>>> and we could put it on the Apache TinkerPop
>>>>> site
>>>>>>> as
>>>>>>>> a
>>>>>>>>>>>>> "Through
>>>>>>>>>>>>>>>>> the
>>>>>>>>>>>>>>>>>>>>>>>>> TinkerPop" tutorial. Be great if you could
>>>>> touch
>>>>>>> on
>>>>>>>>>> every
>>>>>>>>>>>>>>>> aspect
>>>>>>>>>>>>>>>>> of
>>>>>>>>>>>>>>>>>>>>>>>>> the
>>>>>>>>>>>>>>>>>>>>>>>>> TinkerPop framework in the tutorial.
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> I would appreciate a contribution like that.
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> Thanks,
>>>>>>>>>>>>>>>>>>>>>>>>> Marko.
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> http://markorodriguez.com
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
>>>>>>>>>>>>>>>>>> m.ben.franklin@gmail.com>
>>>>>>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen
>>>>>> Mallette <
>>>>>>>>>>>>>>>>>>>>>>>>> spmallette@gmail.com>
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>> My suggestion would be for you to spend
>>>> some
>>>>>> time
>>>>>>>>>>> learning
>>>>>>>>>>>>>>>>> about
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> TinkerPop
>>>>>>>>>>>>>>>>>>>>>>>>>>> (reading the documentation, examining the
>>>>> code
>>>>>>>> base,
>>>>>>>>>>>>> perusing
>>>>>>>>>>>>>>>>> the
>>>>>>>>>>>>>>>>>>>>>>>>>>> Jira
>>>>>>>>>>>>>>>>>>>>>>>>>>> issue tracker, etc.) to determine if any
>>>>>>>> particular
>>>>>>>>>>> part
>>>>>>>>>>>> of
>>>>>>>>>>>>>>>> the
>>>>>>>>>>>>>>>>>>>>>>>>>>> stack
>>>>>>>>>>>>>>>>>>>>>>>>>>> interests you.
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>> IMO, there is no better way to get involved
>>>>>> than
>>>>>>> to
>>>>>>>>>> pick
>>>>>>>>>>>>>>>>> something
>>>>>>>>>>>>>>>>>>>>>>>>>> that
>>>>>>>>>>>>>>>>>>>>>>>>>> needs to be worked on and provide a patch
>>>> for
>>>>>> it.
>>>>>>>> I
>>>>>>>>>>> would
>>>>>>>>>>>>>>>> look
>>>>>>>>>>>>>>>>> at
>>>>>>>>>>>>>>>>>>>>>>>>>> JIRA
>>>>>>>>>>>>>>>>>>>>>>>>>> and
>>>>>>>>>>>>>>>>>>>>>>>>>> find an issue that interests you.
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>> In doing that, you might develop your own
>>>>> ideas
>>>>>>> as
>>>>>>>> to
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> where/what you think you are best suited
>>>> to
>>>>>>>>>> contribute.
>>>>>>>>>>>> At
>>>>>>>>>>>>>>>>> that
>>>>>>>>>>>>>>>>>>>>>>>>>>> point
>>>>>>>>>>>>>>>>>>>>>>>>>>> you
>>>>>>>>>>>>>>>>>>>>>>>>>>> could post those ideas here in the mailing
>>>>>> list
>>>>>>>> for
>>>>>>>>>>>>> feedback.
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos
>>>>>>>> Oikonomou
>>>>>>>>>> <
>>>>>>>>>>>>>>>>>>>>>>>>>>> chrikon1994@gmail.com
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> Hi Stephen
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> When I start I was not familiar with the
>>>>>>> project
>>>>>>>>>> nor
>>>>>>>>>>> the
>>>>>>>>>>>>>>>>>>>>>>>>>>>> architecture/codebase.
>>>>>>>>>>>>>>>>>>>>>>>>>>>> But I am reading about tinkerpop and
>>>>>> searching
>>>>>>> in
>>>>>>>>>> the
>>>>>>>>>>>> code
>>>>>>>>>>>>>>>> and
>>>>>>>>>>>>>>>>>>>>>>>>>>>> I am thinking to make some simple
>>>> examples
>>>>> in
>>>>>>>>>> order to
>>>>>>>>>>>> be
>>>>>>>>>>>>>>>> more
>>>>>>>>>>>>>>>>>>>>>>>>>>>> familiar
>>>>>>>>>>>>>>>>>>>>>>>>>>>> with the functionality.
>>>>>>>>>>>>>>>>>>>>>>>>>>>> So I am not now very familiar but I try
>>>> to
>>>>> be
>>>>>>> in
>>>>>>>>>> the
>>>>>>>>>>>> near
>>>>>>>>>>>>>>>>>> future.
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> Christos
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen
>>>>>>>> Mallette <
>>>>>>>>>>>>>>>>>>>>>>>>>>>> spmallette@gmail.com>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> Hi Christos, we appreciate your offer to
>>>>>>>>>> contribute.
>>>>>>>>>>>>> Could
>>>>>>>>>>>>>>>>> you
>>>>>>>>>>>>>>>>>>>>>>>>>>>> tell
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> us
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> what kind of experience you have with
>>>>>>> TinkerPop
>>>>>>>> so
>>>>>>>>>>> far?
>>>>>>>>>>>>>>>> Are
>>>>>>>>>>>>>>>>>> you
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> at
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> all
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> familiar with the architecture/codebase?
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Stephen
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM,
>>>> Christos
>>>>>>>>>> Oikonomou
>>>>>>>>>>> <
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> chrikon1994@gmail.com>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Dear Tinkerpop Development Team
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> My name is Christos Economou.
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> I would like to contribute in the
>>>>>> tinkerpop3.
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> This contribution will be a part of an
>>>>>>>>>> assignment in
>>>>>>>>>>>> one
>>>>>>>>>>>>>>>> of
>>>>>>>>>>>>>>>>> my
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> classes.
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> I am in my third year of study at Athens
>>>>>>>>>> University of
>>>>>>>>>>>>>>>>> Economics
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> and
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Business (Greece | Hellas).In this
>>>>>> semester I
>>>>>>>>>> attend
>>>>>>>>>>>> in
>>>>>>>>>>>>>>>>>> lectures
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> that
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> called "Advanced Topics in Software
>>>>>>>> Engineering"
>>>>>>>>>> by
>>>>>>>>>>>>>>>>> professor
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Diomidis
>>>>>>>>>>>>>>>>>>>>>>>>>>> Spinellis.
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> As assignment I have to contribute in
>>>> an
>>>>>> open
>>>>>>>>>> source
>>>>>>>>>>>>>>>>> project.
>>>>>>>>>>>>>>>>>> I
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> would
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3.
>>>> More
>>>>>>>>>>> specifically
>>>>>>>>>>>> I
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> understand
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> that
>>>>>>>>>>>>>>>>>>>>>>>>>>> in
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> big projects, like this, always exists
>>>>> work
>>>>>> on
>>>>>>>>>>>>> integration
>>>>>>>>>>>>>>>>> and
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> collaboration between components and
>>>>>>>> subsystems.
>>>>>>>>>> So
>>>>>>>>>>> I
>>>>>>>>>>>> do
>>>>>>>>>>>>>>>> not
>>>>>>>>>>>>>>>>>> have
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> any
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> problem to work on that. But I am more
>>>>>>>>>> interested in
>>>>>>>>>>>>>>>>> creative
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> work
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> like
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> implementation of some algorithm or on a
>>>> new
>>>>>>>>>>>> functionality.
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> I have to mention I have a hard
>>>>> constraint,
>>>>>>>> that
>>>>>>>>>> my
>>>>>>>>>>>>>>>>>> contribution
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> should
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> be
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> at least 100 - 200 lines of code.
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> So I am writing you to ask if you have
>>>> in
>>>>>>> mind
>>>>>>>>>> some
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> functionalities
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> that
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> I
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> can help in development. Here some
>>>>>> information
>>>>>>>>>> about
>>>>>>>>>>> my
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> knowledge in
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> software engineering and programming
>>>>>>> languages
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>> http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> inetpub/detfolio/.
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Thank you for your time and attention.
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Regards,
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Christos Oikonomou
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Assistant researcher at ISTLab
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>> http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>
>>>>>>>>>>>>>>
>>>>>>>>>>>>>
>>>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>
>>>>>
>>>>
>>
>>
Re: Contributing to tinkerpop3
Posted by Stephen Mallette <sp...@gmail.com>.
Hi Christos, I had some time to look at your work in more detail. Again,
this looks like a great feature - thanks for putting the time into building
this.
I like Marko's feedback especially the part about about streamlining the
multiple commands into a single command. I think that will make the
command naming space a bit more tidy. At the moment, I'm not sure that I
have much more functional feedback - I focused more time on the code itself.
It looks like you didn't have any real problems learning the structure and
patterns of the Console. It's good to see that you were able to learn that
stuff as there isn't really any documentation on it.
First and primary issue...this method implementation jumped out at me:
https://github.com/apache/incubator-tinkerpop/pull/71/files#diff-32e4c25b70c7a840a202312f4cc82ccfR54
If i'm not mistaken that's a really important piece of code as it is
responsible for finding methods in the HTML. The issue I'm worried about
is that it seems a bit brittle to me, as you are parsing raw HTML directly
and looping through it with low-level reader functions. IMHO, that makes
the code hard for an outsider to follow without really digging into it to
understand what's going on. I think you're also relying on HTML comments
to find positions in the javadoc and other cues that might not be reliable
(that's just a guess as i don't fully know the internals of the javadoc
generator super well, but it makes me wonder how easily this will crack if
we ever updated the maven javadoc plugin).
given that you are using groovy, i wonder if you couldn't have used the
XmlSlurper to read the HTML. it can actually make parsing HTML/XML quite
enjoyable actually. Your code for finding method names then simplifies to
something like this (didn't test this code, but it's pretty close):
def html = new XmlSlurper().parseText(javadocHtmlString)
html."**".findAll { it.@class.toString().equals("memberNameLink")}.each {
def methodName = it.a[0].text()
def methodUri = it.a[0].@href.text()
}
That's a lot less code to maintain and is easily readable by someone who is
taking a first look at what's going on with your document feature. The
only problem I can imagine is if the XmlSlurper gets annoyed by the HTML
that javadoc produces. In any case, it is worth a shot.
As separate issue, I see that you have some unit tests in place. It would
be nice to see more of those especially around parsing and perhaps even
some integration tests with the console itself. I can provide more
specific feedback in this area after you dig into the issues that have
already be raised to you.
Thanks again for this body of work. I really think it will shape into a
nice feature that will help users in a big way.
Stephen
On Mon, Jun 8, 2015 at 11:57 AM, Marko Rodriguez <ok...@gmail.com>
wrote:
> Hi Christos,
>
> First off, this is a very cool feature. Nice idea and great contribution
> -- and really cool of you to provide the screenshot as that makes things
> easy to grok (
> https://cloud.githubusercontent.com/assets/5932880/8024819/4b571542-0d49-11e5-87f9-f7ac5439b6e5.png).
> Next, here are my thoughts on your implementation. Note that I have not
> looked at your code, just the description/screenshot of what you provided
> in your PR.
>
> You have:
>
> // This is a command for loading of the documentation of a Class*.
> gremlin> :importdocs "Graph"
> //This is a command for displaying the documentation of a method**.
> gremlin> :docs "addVertex"
> //This id a command who returns the current loaded Class.
> gremlin> :currdocs
>
> 1. Auto-Import
> I think we should have a class like ImportCustomizerProvider which
> specifies which classes to have their docs loaded. This way, users don't
> have to do all these imports.
>
> https://github.com/apache/incubator-tinkerpop/blob/master/gremlin-groovy/src/main/java/org/apache/tinkerpop/gremlin/groovy/AbstractImportCustomizerProvider.java#L69
> In fact, if we can just use the classes in ImportCustomizerProvider, that
> would reduce the number of classes to maintain. Also note that we have this
> in our pom.xml to generate the "core" JavaDoc:
>
> https://github.com/apache/incubator-tinkerpop/blob/master/pom.xml#L750-L812
> Perhaps you could just auto-include those classes in the "core" JavaDoc
> specification.
>
> http://tinkerpop.incubator.apache.org/javadocs/3.0.0-SNAPSHOT/core/
>
> 2. Class Disambiguation
> Next, given the above, you may have the same method for two different
> classes. As such, I think your :docs command should be:
> :docs Graph.addVertex
>
> 3. Command Naming
> I don't think we should have multiple : commands for the same feature. We
> should leverage the second argument as the parameterization of the command.
> I think it should be:
> :javadocs import Graph
> // or :javadocs import com.company.tinkerpop.MyPredicate
> if the class is not imported or on disambiguation
> :javadocs view Graph.addVertex
> :javadocs list
>
> I'm not married to ":javadocs" though I don't think it should be ":docs"
> as we use that in our scheme for the AsciiDocs.
>
> http://tinkerpop.incubator.apache.org/javadocs/3.0.0-SNAPSHOT/core/
>
> http://tinkerpop.incubator.apache.org/javadocs/3.0.0-SNAPSHOT/full/
> http://tinkerpop.incubator.apache.org/docs/3.0.0-SNAPSHOT/
>
> 4. System.out.println Look-and-Feel
> I think the outputted String should be of the form:
>
> ===============
> Graph.addVertex
> ===============
> Vertex addVertex(Object… keyValues)
>
> The description of the method just like you have it now.
>
> Parameters:
> keyValues - the key/values pairs to turn into vertex properties
> Returns:
> The newly created vertex
>
> The changes being:
>
> 1. Include the class name in the ===== section.
> 2. The parameters should not have an extra \n but instead, just \t
> indent to make it more compact looking. (or 2-3 spaces instead of \t if \t
> looks weird)
> 3. The return should not have an extra \n but instead, just \t
> indent to make it more compact looking.
> 4. No extra \n at the end before going back to gremlin>.
>
> Thanks Christos,
> Marko.
>
> http://markorodriguez.com
>
> On Jun 8, 2015, at 5:26 AM, Stephen Mallette <sp...@gmail.com> wrote:
>
> > The screenshot you provided on the PR looks pretty cool! We'll take a
> look
> > at it in more detail...thanks.
> >
> > On Mon, Jun 8, 2015 at 4:51 AM, Christos Oikonomou <
> chrikon1994@gmail.com>
> > wrote:
> >
> >> Hello everyone,
> >>
> >> I have finished my work on commands and I have done a pull request
> >> yesterday!
> >> (The checking with travis BI will be done when my request is overviewed
> for
> >> the pull request or I should do it myself?)
> >>
> >> If you have some time review my submission for feedback and corrections.
> >>
> >> Thank you for your time anyway
> >>
> >> Regards,
> >> Christos
> >>
> >> On Tue, May 26, 2015 at 6:14 PM, Stephen Mallette <spmallette@gmail.com
> >
> >> wrote:
> >>
> >>> I'd forgotten that we package the javadoc with the zip. I think that
> >> makes
> >>> sense. Feel free to share the link to your fork (and more information
> >>> about your design, like how the commands work) when you are ready,
> >> however
> >>> the earlier you get feedback the more helpful it might be to you.
> >>>
> >>> On Tue, May 26, 2015 at 10:05 AM, Christos Oikonomou <
> >>> chrikon1994@gmail.com>
> >>> wrote:
> >>>
> >>>> Hello Stephen,
> >>>> I thought that it would be better to avoid reading url if we provide
> >> the
> >>>> .html in the release zip.
> >>>> That's why I thought to create two methods to read the javadocs
> locally
> >>>> (why I need the path) or if that fails to go to url. I f you believe
> >> that
> >>>> is not necessary this works fine for me also because it is a lot of
> >> work.
> >>>> But this operation will not work off line.
> >>>> For the repo yes I have one folk but I have not finnish all the
> >>>> documentation and junit so I have not push yet, when I do I will send
> >> you
> >>>> the link.
> >>>> Regards,
> >>>> Christos
> >>>>
> >>>> On Tue, May 26, 2015 at 2:44 PM, Stephen Mallette <
> >> spmallette@gmail.com>
> >>>> wrote:
> >>>>
> >>>>> Hi Christos - I assume that you have a fork of TinkerPop3 somewhere?
> >>>>> Perhaps you could point us to your code so that we can see what
> >> you've
> >>>>> done? It might be easier to discuss if we could see that. Also, it
> >>>> would
> >>>>> be helpful to know more about your proposed syntax to your commands
> >> and
> >>>>> what they will do.
> >>>>>
> >>>>>> Secondly what is the correct path for the javadoc in release and in
> >>>>> development
> >>>>> version?
> >>>>>
> >>>>> We deploy javadocs for every official release and for the current
> >>>>> SNAPSHOT. The Console can find the current version by calling
> >>>>> Gremlin.version() - you should be able to use that to construct the
> >>> right
> >>>>> URL to the javadoc. I think that would work.
> >>>>>
> >>>>>
> >>>>>
> >>>>> On Mon, May 25, 2015 at 9:15 AM, Christos Oikonomou <
> >>>> chrikon1994@gmail.com
> >>>>>>
> >>>>> wrote:
> >>>>>
> >>>>>> Hello everyone
> >>>>>>
> >>>>>> I was working on Java displaying in gremlin console.
> >>>>>> I have came to a point that I need your guidance.
> >>>>>> I have made 3 classes one for importing, for Doc structure in a
> >> class
> >>>> and
> >>>>>> third for the structure of the data in a method.
> >>>>>>
> >>>>>> Also I add 2 commands in groovy the ImportDocsCommand and
> >>> DicsCommand.
> >>>>> The
> >>>>>> first impliment the import of the javadocs of a class for the
> >>>> Class.html
> >>>>>> and the second the displaying.
> >>>>>>
> >>>>>> Firstly what are your thoughts for those,
> >>>>>>
> >>>>>> Secondly what is the correct path for the javadoc in release and in
> >>>>>> development version?
> >>>>>>
> >>>>>> Regards
> >>>>>> Christos
> >>>>>>
> >>>>>> On Sat, Apr 25, 2015 at 2:59 PM, Christos Oikonomou <
> >>>>> chrikon1994@gmail.com
> >>>>>>>
> >>>>>> wrote:
> >>>>>>
> >>>>>>> I thought we can create an doc.xml with all the relative
> >>> information
> >>>>>>> gathered for every function.
> >>>>>>>
> >>>>>>> Although I see your point.
> >>>>>>>
> >>>>>>> But I like also the idea of Matt.....
> >>>>>>>
> >>>>>>> As I see this was something that interest you so I will start
> >>> working
> >>>>> on
> >>>>>>> how that should be implemented.
> >>>>>>>
> >>>>>>> Regards,
> >>>>>>> Christos
> >>>>>>>
> >>>>>>> On Sat, Apr 25, 2015 at 1:35 PM, Stephen Mallette <
> >>>>> spmallette@gmail.com>
> >>>>>>> wrote:
> >>>>>>>
> >>>>>>>> Matt, I like idea for a :docimport command. By default we would
> >>>> load
> >>>>>>>> GraphTraversal into it so that
> >>>>>>>>
> >>>>>>>> gremlin> :doc outE
> >>>>>>>>
> >>>>>>>> could resolve to the appropriate javadoc right out the box. It
> >> is
> >>>>>>>> generally applicable and as you say might even be of interest to
> >>> the
> >>>>>>>> groovy
> >>>>>>>> project at some point.
> >>>>>>>>
> >>>>>>>> Christos, I think the categories you mention are good, but I
> >> would
> >>>>> take
> >>>>>>>> care to consider the source of the documentation. Where would
> >>> those
> >>>>>>>> categories come from for you to display them? I don't think it
> >>> would
> >>>>> be
> >>>>>>>> especially helpful if we had to manage javadoc, the asciidoc and
> >>>> then
> >>>>>>>> another class of documentation for the console. I think that
> >>>>>> re-purposing
> >>>>>>>> the javadoc is the best approach here and if we write some good
> >>>>> javadoc
> >>>>>> we
> >>>>>>>> will roughly cover your categories. You could obviously display
> >>> the
> >>>>>> text
> >>>>>>>> of the javadoc, which would likely cover your first two
> >> categories
> >>>> (if
> >>>>>>>> written well). For the links, we could add @see tags as needed
> >> to
> >>>> the
> >>>>>>>> javadoc and those would be the links to display in the console.
> >>>>>>>>
> >>>>>>>>
> >>>>>>>>
> >>>>>>>>
> >>>>>>>>
> >>>>>>>> On Fri, Apr 24, 2015 at 7:13 PM, Christos Oikonomou <
> >>>>>>>> chrikon1994@gmail.com>
> >>>>>>>> wrote:
> >>>>>>>>
> >>>>>>>>> I am glad for your reaction.
> >>>>>>>>> I was thinking that we can display the information in 4
> >>> categories
> >>>>>>>>>
> >>>>>>>>> gremlin> :doc foo
> >>>>>>>>> Description of Functionality
> >>>>>>>>> .....
> >>>>>>>>> Some relevant functionalities
> >>>>>>>>> ......
> >>>>>>>>> Link to the user documentation
> >>>>>>>>> ......
> >>>>>>>>> Link to the javadoc
> >>>>>>>>> .........
> >>>>>>>>>
> >>>>>>>>> Do you believe that informations will be clear to all kinds of
> >>>> users
> >>>>>>>>>
> >>>>>>>>> On Sat, Apr 25, 2015 at 12:36 AM, Matt Frantz <
> >>>>>>>> matthew.h.frantz@gmail.com>
> >>>>>>>>> wrote:
> >>>>>>>>>
> >>>>>>>>>> Perhaps there should be a command to import the javadocs
> >> for a
> >>>>>>>> particular
> >>>>>>>>>> package or interface, e.g. a DSL interface. The effect
> >> would
> >>> be
> >>>>> to
> >>>>>>>> haul
> >>>>>>>>>> the methods into the global doc namespace. By default, we
> >>> would
> >>>>>> apply
> >>>>>>>>> that
> >>>>>>>>>> to GraphTraversal.
> >>>>>>>>>>
> >>>>>>>>>> gremlin> :doc outE
> >>>>>>>>>> TODO: Write a good javadoc for each GraphTraversal method
> >>>>>>>>>> gremlin> :importdoc TinkerFactory.SocialTraversal
> >>>>>>>>>> gremlin> :doc people
> >>>>>>>>>> TODO: Write a good javadoc for each SocialTraversal method
> >>>>>>>>>>
> >>>>>>>>>> It could be applied to any class or interface. Applying it
> >>> to a
> >>>>>>>> package
> >>>>>>>>>> would haul the classes and subpackages into the global doc
> >>>>>> namespace.
> >>>>>>>>>>
> >>>>>>>>>> gremlin> :importdoc
> >>>>>> org.apache.tinkerpop.gremlin.tinkergraph.structure
> >>>>>>>>>> gremlin> :doc TinkerHelper
> >>>>>>>>>> gremlin> :doc TinkerHelper.queryVertexIndex
> >>>>>>>>>>
> >>>>>>>>>> Maybe you could allow fully-qualified resolution without an
> >>>>> import:
> >>>>>>>>>>
> >>>>>>>>>> gremlin> :doc
> >>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>>
> >>>>>>>>
> >>>>>>
> >>>>>
> >>>>
> >>>
> >>
> org.apache.tinkerpop.gremlin.tinkergraph.structure.TinkerHelper.queryVertexIndex
> >>>>>>>>>>
> >>>>>>>>>> This seems like something that could be contributed upstream
> >>> to
> >>>>> the
> >>>>>>>>> Groovy
> >>>>>>>>>> REPL.
> >>>>>>>>>>
> >>>>>>>>>> On Fri, Apr 24, 2015 at 12:10 PM, Stephen Mallette <
> >>>>>>>> spmallette@gmail.com
> >>>>>>>>>>
> >>>>>>>>>> wrote:
> >>>>>>>>>>
> >>>>>>>>>>> Yeah - it would be straightforward to bring in javadoc for
> >>> the
> >>>>>> most
> >>>>>>>>> part:
> >>>>>>>>>>>
> >>>>>>>>>>> gremlin> :doc EdgeVertexStep
> >>>>>>>>>>>
> >>>>>>>>>>> you can get the class from that and full package name with
> >>>>>>>> reflection
> >>>>>>>>>> then
> >>>>>>>>>>> translate it to javadoc to extract some text to display in
> >>> the
> >>>>>>>> console.
> >>>>>>>>>> I
> >>>>>>>>>>> guess that's nice, but no one knows VertexStep. They know
> >>>> this
> >>>>>> step
> >>>>>>>>>>> though:
> >>>>>>>>>>>
> >>>>>>>>>>> gremlin> :doc outE
> >>>>>>>>>>>
> >>>>>>>>>>> So - I guess the question is how one would go from just a
> >>> pure
> >>>>>>>> javadoc
> >>>>>>>>>>> lookup command (cool but a bit less useful to a first time
> >>>> user
> >>>>>> who
> >>>>>>>>>> doesn't
> >>>>>>>>>>> know the classes - not that EdgeVertexStep would yield
> >>>> anything
> >>>>>>>> about
> >>>>>>>>>> outE
> >>>>>>>>>>> for that matter as it sits) to something that gives the
> >> user
> >>>>>>>> content on
> >>>>>>>>>>> steps from GraphTraversal which is the core of the DSL.
> >> And
> >>>>> then
> >>>>>> -
> >>>>>>>> how
> >>>>>>>>>>> would it extend to other DSLs so that it was generally
> >>>>> applicable
> >>>>>> to
> >>>>>>>>>> those
> >>>>>>>>>>> extending the language.
> >>>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>> On Fri, Apr 24, 2015 at 3:02 PM, Marko Rodriguez <
> >>>>>>>> okrammarko@gmail.com
> >>>>>>>>>>
> >>>>>>>>>>> wrote:
> >>>>>>>>>>>
> >>>>>>>>>>>> That would be really classy. It would be cool if that
> >>> could
> >>>> be
> >>>>>>>> read
> >>>>>>>>>> from
> >>>>>>>>>>>> the JavaDoc somehow………… then we kill two birds with one
> >>>> stone.
> >>>>>>>>>>>>
> >>>>>>>>>>>> Marko.
> >>>>>>>>>>>>
> >>>>>>>>>>>> http://markorodriguez.com
> >>>>>>>>>>>>
> >>>>>>>>>>>> On Apr 24, 2015, at 12:08 PM, Stephen Mallette <
> >>>>>>>> spmallette@gmail.com
> >>>>>>>>>>
> >>>>>>>>>>>> wrote:
> >>>>>>>>>>>>
> >>>>>>>>>>>>>> A gremlin-command that display in gremlin-console
> >> user
> >>>>>>>>> documentation
> >>>>>>>>>>> or
> >>>>>>>>>>>>> javadocs of a gremlin functionality could be something
> >>>> that
> >>>>>>>> helps
> >>>>>>>>>> user?
> >>>>>>>>>>>>>
> >>>>>>>>>>>>> That's an interesting idea. I assume you are
> >> suggesting
> >>>>>>>> something
> >>>>>>>>>>> like:
> >>>>>>>>>>>>>
> >>>>>>>>>>>>> gremlin> :doc choose
> >>>>>>>>>>>>> ==>The choose()-step (branch) routes the current
> >>> traverser
> >>>>> to
> >>>>>> a
> >>>>>>>>>>>> particular
> >>>>>>>>>>>>> traversal branch option. With choose(), it is possible
> >>> to
> >>>>>>>>>>> implement......
> >>>>>>>>>>>>>
> >>>>>>>>>>>>> Is that what you mean?
> >>>>>>>>>>>>>
> >>>>>>>>>>>>>
> >>>>>>>>>>>>>
> >>>>>>>>>>>>>
> >>>>>>>>>>>>> On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <
> >>>>>>>>>>>> chrikon1994@gmail.com>
> >>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>
> >>>>>>>>>>>>>> Hello and sorry for the delay. Thanks for the
> >> answers.
> >>>>>>>>>>>>>> I have done a general overview of all the code base.
> >>> But
> >>>>> more
> >>>>>>>>>>>> familiarized
> >>>>>>>>>>>>>> I am in gremlin-core and gremlin-console.
> >>>>>>>>>>>>>> I prefer the assignment of issues because I wants to
> >>> help
> >>>>>> also
> >>>>>>>> to
> >>>>>>>>>> the
> >>>>>>>>>>>>>> faster achievement of the project planning in
> >> general.
> >>>>>>>>>>>>>> Also I have an idea in documentation. A
> >> gremlin-command
> >>>>> that
> >>>>>>>>> display
> >>>>>>>>>>> in
> >>>>>>>>>>>>>> gremlin-console user documentation or javadocs of a
> >>>> gremlin
> >>>>>>>>>>>> functionality
> >>>>>>>>>>>>>> could be something that helps user?
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>> Regards,
> >>>>>>>>>>>>>> Christos
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <
> >>>>>>>>>>>> m.ben.franklin@gmail.com>
> >>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <
> >>>>>>>>>>> okrammarko@gmail.com>
> >>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> Hi Christos,
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> Given that you have familiarized yourself with the
> >>>>>> codebase,
> >>>>>>>>> which
> >>>>>>>>>>>> area
> >>>>>>>>>>>>>>> of
> >>>>>>>>>>>>>>>> the codebase do you feel:
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> 1. you understand the best, and
> >>>>>>>>>>>>>>>> 2. are interested in working on.
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> Given that information, I will be able to figure
> >> out
> >>>>>>>> something
> >>>>>>>>>>>>>> particular
> >>>>>>>>>>>>>>>> for you to do.
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> You should also feel free to pick an issue off of
> >> JIRA
> >>>>>>>> yourself,
> >>>>>>>>> or
> >>>>>>>>>>>> even
> >>>>>>>>>>>>>>> create an issue and submit a patch for it.
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> Thanks,
> >>>>>>>>>>>>>>>> Marko.
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> http://markorodriguez.com
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
> >>>>>>>>>>>>>> chrikon1994@gmail.com>
> >>>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>> Hello everyone,
> >>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>> I have read your advices how to start and how to
> >> be
> >>>>>>>>> familiarized
> >>>>>>>>>>> with
> >>>>>>>>>>>>>>> the
> >>>>>>>>>>>>>>>>> codebase. After some time I spent exploring the
> >>> code,
> >>>> I
> >>>>>>>>> believe I
> >>>>>>>>>>> am
> >>>>>>>>>>>>>>>> ready
> >>>>>>>>>>>>>>>>> to start specific changes in the code.
> >>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>> So am sending this message to ask you, if some of
> >>> you
> >>>>> have
> >>>>>>>>> ideas
> >>>>>>>>>>>>>> about
> >>>>>>>>>>>>>>>>> features or improvement and you want one more for
> >>>> help.
> >>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>> Also if you have some issues you want some help
> >>> please
> >>>>> let
> >>>>>>>> me
> >>>>>>>>>> know
> >>>>>>>>>>>>>>> (jira
> >>>>>>>>>>>>>>>>> account chrikon).
> >>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>> Thanks in advance,
> >>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>> Regards
> >>>>>>>>>>>>>>>>> Christos
> >>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos
> >> Oikonomou
> >>> <
> >>>>>>>>>>>>>>>> chrikon1994@gmail.com>
> >>>>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>> Sorry Hadrian thank you for your correction, this
> >>>> will
> >>>>>> not
> >>>>>>>>>> happen
> >>>>>>>>>>>>>>> again!
> >>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea
> >> <
> >>>>>>>>>>>>>> hzbarcea@gmail.com>
> >>>>>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>> Hi Christos,
> >>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>> First off, I am not a Mister :), just Hadrian.
> >>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>> Yes, the idea is to collaborate, that's what
> >> open
> >>>>> source
> >>>>>>>> is
> >>>>>>>>>>> about.
> >>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>> Good luck,
> >>>>>>>>>>>>>>>>>>> Hadrian
> >>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou
> >> wrote:
> >>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>> Firstly thank you all for your suggestions, all
> >>> of
> >>>>> them
> >>>>>>>> are
> >>>>>>>>>> very
> >>>>>>>>>>>>>>>> helpful.
> >>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>> In this moment I follow the very good advice
> >> and
> >>> I
> >>>> am
> >>>>>>>>> reading
> >>>>>>>>>>>>>>>>>>>> documentation, because next Wednesday I have to
> >>>> make
> >>>>> a
> >>>>>>>>>>>>>> presentation
> >>>>>>>>>>>>>>>> for
> >>>>>>>>>>>>>>>>>>>> tinkerpop in front of my class!
> >>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>> Marko I have to write code for my assignment,
> >> but
> >>>> in
> >>>>> my
> >>>>>>>> free
> >>>>>>>>>>> time
> >>>>>>>>>>>>>> it
> >>>>>>>>>>>>>>>> is
> >>>>>>>>>>>>>>>>>>>> an
> >>>>>>>>>>>>>>>>>>>> interesting work.
> >>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>> Although Javadoc it is applicable to my
> >>>> assignment, I
> >>>>>>>>> think. I
> >>>>>>>>>>>>>> will
> >>>>>>>>>>>>>>>> ask
> >>>>>>>>>>>>>>>>>>>> and
> >>>>>>>>>>>>>>>>>>>> I will have news.
> >>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>> If Mr. Hadrian Zbarcea are working on it, I
> >> would
> >>>>> like
> >>>>>>>> not
> >>>>>>>>> to
> >>>>>>>>>>>>>>>> interfere
> >>>>>>>>>>>>>>>>>>>> in
> >>>>>>>>>>>>>>>>>>>> your job, or we can cooperate.
> >>>>>>>>>>>>>>>>>>>> Before that discussion I have to contact to my
> >>>>> academic
> >>>>>>>>>>> supervisor
> >>>>>>>>>>>>>>> in
> >>>>>>>>>>>>>>>>>>>> order
> >>>>>>>>>>>>>>>>>>>> to be 100% sure that this is ok.
> >>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>> P.S. I hope my English is at least
> >>> understandable,
> >>>> if
> >>>>>>>> not so
> >>>>>>>>>>>>>> please
> >>>>>>>>>>>>>>>> ask
> >>>>>>>>>>>>>>>>>>>> me
> >>>>>>>>>>>>>>>>>>>> again.
> >>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>> Thank you all.
> >>>>>>>>>>>>>>>>>>>> Christos
> >>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian
> >> Zbarcea
> >>> <
> >>>>>>>>>>>>>>> hzbarcea@gmail.com>
> >>>>>>>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>> That's something I am interested in too.
> >>>>>>>>>>>>>>>>>>>>> Hadrian
> >>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
> >>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>> Hi Christos,
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>> Another thing that we need is more JavaDoc!
> >> Its
> >>>> not
> >>>>>>>> sexy,
> >>>>>>>>>> but
> >>>>>>>>>>>>>> boy
> >>>>>>>>>>>>>>>> would
> >>>>>>>>>>>>>>>>>>>>>> be it be great to have someone go through and
> >>>>>>>> JavaDoc-up
> >>>>>>>>>>>>>>>> GraphTraversal
> >>>>>>>>>>>>>>>>>>>>>> (all those methods…).
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>> …the docs provide a description of each step.
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>> http://tinkerpop.incubator.apache.org/docs/3.0.0-
> >>>>>>>>>>>>>>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct
> >>>>> clicking
> >>>>>> to
> >>>>>>>>> any
> >>>>>>>>>>>>>>>> particular
> >>>>>>>>>>>>>>>>>>>>>> step)
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>> I would say that would be more helpful now
> >>> than a
> >>>>>>>> "Through
> >>>>>>>>>> the
> >>>>>>>>>>>>>>>>>>>>>> TinkerPop"-tutorial.
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>> Finally, what else would be helpful --- more
> >>> test
> >>>>>>>> cases.
> >>>>>>>>> If
> >>>>>>>>>>> you
> >>>>>>>>>>>>>>> are
> >>>>>>>>>>>>>>>>>>>>>> interested in testing, I can get your set up
> >> in
> >>>>> with
> >>>>>> "a
> >>>>>>>>>>> pattern"
> >>>>>>>>>>>>>>> so
> >>>>>>>>>>>>>>>>>>>>>> you pop
> >>>>>>>>>>>>>>>>>>>>>> out more process/ tests. For example:
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
> >>>>>>>>>>>>>>>>>>>>>>
> >>> gremlin/process/traversal/step/map/CountTest.java
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>> Thanks,
> >>>>>>>>>>>>>>>>>>>>>> Marko.
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>> http://markorodriguez.com
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez
> >> <
> >>>>>>>>>>>>>>> okrammarko@gmail.com>
> >>>>>>>>>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>> Hi Christos,
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>> Are you interested in writing code or
> >> perhaps,
> >>>>>>>> writing a
> >>>>>>>>>>>>>>> tutorial?
> >>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>> It would be nice to have an in-depth
> >> tutorial
> >>> on
> >>>>>>>>>> TinkerPop3.
> >>>>>>>>>>>>>> For
> >>>>>>>>>>>>>>>>>>>>>>> instance, find a reasonably sized dataset
> >> (<1
> >>>>>> million
> >>>>>>>>>> edges),
> >>>>>>>>>>>>>>> parse
> >>>>>>>>>>>>>>>>>>>>>>> it into
> >>>>>>>>>>>>>>>>>>>>>>> a graph, do some analysis on it, expose it
> >> via
> >>>>>> Gremlin
> >>>>>>>>>>> Server,
> >>>>>>>>>>>>>>> OLTP
> >>>>>>>>>>>>>>>>>>>>>>> and
> >>>>>>>>>>>>>>>>>>>>>>> OLAP queries hitting it, etc. Write up the
> >>> path
> >>>>> you
> >>>>>>>> took
> >>>>>>>>>> into
> >>>>>>>>>>>>>> an
> >>>>>>>>>>>>>>>>>>>>>>> AsciiDoc
> >>>>>>>>>>>>>>>>>>>>>>> and we could put it on the Apache TinkerPop
> >>> site
> >>>>> as
> >>>>>> a
> >>>>>>>>>>> "Through
> >>>>>>>>>>>>>>> the
> >>>>>>>>>>>>>>>>>>>>>>> TinkerPop" tutorial. Be great if you could
> >>> touch
> >>>>> on
> >>>>>>>> every
> >>>>>>>>>>>>>> aspect
> >>>>>>>>>>>>>>> of
> >>>>>>>>>>>>>>>>>>>>>>> the
> >>>>>>>>>>>>>>>>>>>>>>> TinkerPop framework in the tutorial.
> >>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>> I would appreciate a contribution like that.
> >>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>> Thanks,
> >>>>>>>>>>>>>>>>>>>>>>> Marko.
> >>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>> http://markorodriguez.com
> >>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
> >>>>>>>>>>>>>>>> m.ben.franklin@gmail.com>
> >>>>>>>>>>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen
> >>>> Mallette <
> >>>>>>>>>>>>>>>>>>>>>>> spmallette@gmail.com>
> >>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>> My suggestion would be for you to spend
> >> some
> >>>> time
> >>>>>>>>> learning
> >>>>>>>>>>>>>>> about
> >>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>> TinkerPop
> >>>>>>>>>>>>>>>>>>>>>>>>> (reading the documentation, examining the
> >>> code
> >>>>>> base,
> >>>>>>>>>>> perusing
> >>>>>>>>>>>>>>> the
> >>>>>>>>>>>>>>>>>>>>>>>>> Jira
> >>>>>>>>>>>>>>>>>>>>>>>>> issue tracker, etc.) to determine if any
> >>>>>> particular
> >>>>>>>>> part
> >>>>>>>>>> of
> >>>>>>>>>>>>>> the
> >>>>>>>>>>>>>>>>>>>>>>>>> stack
> >>>>>>>>>>>>>>>>>>>>>>>>> interests you.
> >>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>> IMO, there is no better way to get involved
> >>>> than
> >>>>> to
> >>>>>>>> pick
> >>>>>>>>>>>>>>> something
> >>>>>>>>>>>>>>>>>>>>>>>> that
> >>>>>>>>>>>>>>>>>>>>>>>> needs to be worked on and provide a patch
> >> for
> >>>> it.
> >>>>>> I
> >>>>>>>>> would
> >>>>>>>>>>>>>> look
> >>>>>>>>>>>>>>> at
> >>>>>>>>>>>>>>>>>>>>>>>> JIRA
> >>>>>>>>>>>>>>>>>>>>>>>> and
> >>>>>>>>>>>>>>>>>>>>>>>> find an issue that interests you.
> >>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>> In doing that, you might develop your own
> >>> ideas
> >>>>> as
> >>>>>> to
> >>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>> where/what you think you are best suited
> >> to
> >>>>>>>> contribute.
> >>>>>>>>>> At
> >>>>>>>>>>>>>>> that
> >>>>>>>>>>>>>>>>>>>>>>>>> point
> >>>>>>>>>>>>>>>>>>>>>>>>> you
> >>>>>>>>>>>>>>>>>>>>>>>>> could post those ideas here in the mailing
> >>>> list
> >>>>>> for
> >>>>>>>>>>> feedback.
> >>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos
> >>>>>> Oikonomou
> >>>>>>>> <
> >>>>>>>>>>>>>>>>>>>>>>>>> chrikon1994@gmail.com
> >>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>> Hi Stephen
> >>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>> When I start I was not familiar with the
> >>>>> project
> >>>>>>>> nor
> >>>>>>>>> the
> >>>>>>>>>>>>>>>>>>>>>>>>>> architecture/codebase.
> >>>>>>>>>>>>>>>>>>>>>>>>>> But I am reading about tinkerpop and
> >>>> searching
> >>>>> in
> >>>>>>>> the
> >>>>>>>>>> code
> >>>>>>>>>>>>>> and
> >>>>>>>>>>>>>>>>>>>>>>>>>> I am thinking to make some simple
> >> examples
> >>> in
> >>>>>>>> order to
> >>>>>>>>>> be
> >>>>>>>>>>>>>> more
> >>>>>>>>>>>>>>>>>>>>>>>>>> familiar
> >>>>>>>>>>>>>>>>>>>>>>>>>> with the functionality.
> >>>>>>>>>>>>>>>>>>>>>>>>>> So I am not now very familiar but I try
> >> to
> >>> be
> >>>>> in
> >>>>>>>> the
> >>>>>>>>>> near
> >>>>>>>>>>>>>>>> future.
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>> Christos
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen
> >>>>>> Mallette <
> >>>>>>>>>>>>>>>>>>>>>>>>>> spmallette@gmail.com>
> >>>>>>>>>>>>>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>> Hi Christos, we appreciate your offer to
> >>>>>>>> contribute.
> >>>>>>>>>>> Could
> >>>>>>>>>>>>>>> you
> >>>>>>>>>>>>>>>>>>>>>>>>>> tell
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>> us
> >>>>>>>>>>>>>>>>>>>>>>>>>>> what kind of experience you have with
> >>>>> TinkerPop
> >>>>>> so
> >>>>>>>>> far?
> >>>>>>>>>>>>>> Are
> >>>>>>>>>>>>>>>> you
> >>>>>>>>>>>>>>>>>>>>>>>>>>> at
> >>>>>>>>>>>>>>>>>>>>>>>>>>> all
> >>>>>>>>>>>>>>>>>>>>>>>>>>> familiar with the architecture/codebase?
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>> Stephen
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM,
> >> Christos
> >>>>>>>> Oikonomou
> >>>>>>>>> <
> >>>>>>>>>>>>>>>>>>>>>>>>>>> chrikon1994@gmail.com>
> >>>>>>>>>>>>>>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>> Dear Tinkerpop Development Team
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> My name is Christos Economou.
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> I would like to contribute in the
> >>>> tinkerpop3.
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> This contribution will be a part of an
> >>>>>>>> assignment in
> >>>>>>>>>> one
> >>>>>>>>>>>>>> of
> >>>>>>>>>>>>>>> my
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> classes.
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>> I am in my third year of study at Athens
> >>>>>>>> University of
> >>>>>>>>>>>>>>> Economics
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> and
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> Business (Greece | Hellas).In this
> >>>> semester I
> >>>>>>>> attend
> >>>>>>>>>> in
> >>>>>>>>>>>>>>>> lectures
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> that
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> called "Advanced Topics in Software
> >>>>>> Engineering"
> >>>>>>>> by
> >>>>>>>>>>>>>>> professor
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> Diomidis
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>> Spinellis.
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> As assignment I have to contribute in
> >> an
> >>>> open
> >>>>>>>> source
> >>>>>>>>>>>>>>> project.
> >>>>>>>>>>>>>>>> I
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> would
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3.
> >> More
> >>>>>>>>> specifically
> >>>>>>>>>> I
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> understand
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> that
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>> in
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>> big projects, like this, always exists
> >>> work
> >>>> on
> >>>>>>>>>>> integration
> >>>>>>>>>>>>>>> and
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> collaboration between components and
> >>>>>> subsystems.
> >>>>>>>> So
> >>>>>>>>> I
> >>>>>>>>>> do
> >>>>>>>>>>>>>> not
> >>>>>>>>>>>>>>>> have
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> any
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> problem to work on that. But I am more
> >>>>>>>> interested in
> >>>>>>>>>>>>>>> creative
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> work
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> like
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>> implementation of some algorithm or on a
> >> new
> >>>>>>>>>> functionality.
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> I have to mention I have a hard
> >>> constraint,
> >>>>>> that
> >>>>>>>> my
> >>>>>>>>>>>>>>>> contribution
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> should
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>> be
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>> at least 100 - 200 lines of code.
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> So I am writing you to ask if you have
> >> in
> >>>>> mind
> >>>>>>>> some
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> functionalities
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> that
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>> I
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>> can help in development. Here some
> >>>> information
> >>>>>>>> about
> >>>>>>>>> my
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> knowledge in
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> software engineering and programming
> >>>>> languages
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>> http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>> inetpub/detfolio/.
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>> Thank you for your time and attention.
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> Regards,
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> Christos Oikonomou
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> Assistant researcher at ISTLab
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>> http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
> >>>>>>>>>>>>>>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>
> >>>>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>>
> >>>>>>>>
> >>>>>>>
> >>>>>>>
> >>>>>>
> >>>>>
> >>>>
> >>>
> >>
>
>
Re: Contributing to tinkerpop3
Posted by Marko Rodriguez <ok...@gmail.com>.
Hi Christos,
First off, this is a very cool feature. Nice idea and great contribution -- and really cool of you to provide the screenshot as that makes things easy to grok (https://cloud.githubusercontent.com/assets/5932880/8024819/4b571542-0d49-11e5-87f9-f7ac5439b6e5.png). Next, here are my thoughts on your implementation. Note that I have not looked at your code, just the description/screenshot of what you provided in your PR.
You have:
// This is a command for loading of the documentation of a Class*.
gremlin> :importdocs "Graph"
//This is a command for displaying the documentation of a method**.
gremlin> :docs "addVertex"
//This id a command who returns the current loaded Class.
gremlin> :currdocs
1. Auto-Import
I think we should have a class like ImportCustomizerProvider which specifies which classes to have their docs loaded. This way, users don't have to do all these imports.
https://github.com/apache/incubator-tinkerpop/blob/master/gremlin-groovy/src/main/java/org/apache/tinkerpop/gremlin/groovy/AbstractImportCustomizerProvider.java#L69
In fact, if we can just use the classes in ImportCustomizerProvider, that would reduce the number of classes to maintain. Also note that we have this in our pom.xml to generate the "core" JavaDoc:
https://github.com/apache/incubator-tinkerpop/blob/master/pom.xml#L750-L812
Perhaps you could just auto-include those classes in the "core" JavaDoc specification.
http://tinkerpop.incubator.apache.org/javadocs/3.0.0-SNAPSHOT/core/
2. Class Disambiguation
Next, given the above, you may have the same method for two different classes. As such, I think your :docs command should be:
:docs Graph.addVertex
3. Command Naming
I don't think we should have multiple : commands for the same feature. We should leverage the second argument as the parameterization of the command. I think it should be:
:javadocs import Graph
// or :javadocs import com.company.tinkerpop.MyPredicate if the class is not imported or on disambiguation
:javadocs view Graph.addVertex
:javadocs list
I'm not married to ":javadocs" though I don't think it should be ":docs" as we use that in our scheme for the AsciiDocs.
http://tinkerpop.incubator.apache.org/javadocs/3.0.0-SNAPSHOT/core/
http://tinkerpop.incubator.apache.org/javadocs/3.0.0-SNAPSHOT/full/
http://tinkerpop.incubator.apache.org/docs/3.0.0-SNAPSHOT/
4. System.out.println Look-and-Feel
I think the outputted String should be of the form:
===============
Graph.addVertex
===============
Vertex addVertex(Object… keyValues)
The description of the method just like you have it now.
Parameters:
keyValues - the key/values pairs to turn into vertex properties
Returns:
The newly created vertex
The changes being:
1. Include the class name in the ===== section.
2. The parameters should not have an extra \n but instead, just \t indent to make it more compact looking. (or 2-3 spaces instead of \t if \t looks weird)
3. The return should not have an extra \n but instead, just \t indent to make it more compact looking.
4. No extra \n at the end before going back to gremlin>.
Thanks Christos,
Marko.
http://markorodriguez.com
On Jun 8, 2015, at 5:26 AM, Stephen Mallette <sp...@gmail.com> wrote:
> The screenshot you provided on the PR looks pretty cool! We'll take a look
> at it in more detail...thanks.
>
> On Mon, Jun 8, 2015 at 4:51 AM, Christos Oikonomou <ch...@gmail.com>
> wrote:
>
>> Hello everyone,
>>
>> I have finished my work on commands and I have done a pull request
>> yesterday!
>> (The checking with travis BI will be done when my request is overviewed for
>> the pull request or I should do it myself?)
>>
>> If you have some time review my submission for feedback and corrections.
>>
>> Thank you for your time anyway
>>
>> Regards,
>> Christos
>>
>> On Tue, May 26, 2015 at 6:14 PM, Stephen Mallette <sp...@gmail.com>
>> wrote:
>>
>>> I'd forgotten that we package the javadoc with the zip. I think that
>> makes
>>> sense. Feel free to share the link to your fork (and more information
>>> about your design, like how the commands work) when you are ready,
>> however
>>> the earlier you get feedback the more helpful it might be to you.
>>>
>>> On Tue, May 26, 2015 at 10:05 AM, Christos Oikonomou <
>>> chrikon1994@gmail.com>
>>> wrote:
>>>
>>>> Hello Stephen,
>>>> I thought that it would be better to avoid reading url if we provide
>> the
>>>> .html in the release zip.
>>>> That's why I thought to create two methods to read the javadocs locally
>>>> (why I need the path) or if that fails to go to url. I f you believe
>> that
>>>> is not necessary this works fine for me also because it is a lot of
>> work.
>>>> But this operation will not work off line.
>>>> For the repo yes I have one folk but I have not finnish all the
>>>> documentation and junit so I have not push yet, when I do I will send
>> you
>>>> the link.
>>>> Regards,
>>>> Christos
>>>>
>>>> On Tue, May 26, 2015 at 2:44 PM, Stephen Mallette <
>> spmallette@gmail.com>
>>>> wrote:
>>>>
>>>>> Hi Christos - I assume that you have a fork of TinkerPop3 somewhere?
>>>>> Perhaps you could point us to your code so that we can see what
>> you've
>>>>> done? It might be easier to discuss if we could see that. Also, it
>>>> would
>>>>> be helpful to know more about your proposed syntax to your commands
>> and
>>>>> what they will do.
>>>>>
>>>>>> Secondly what is the correct path for the javadoc in release and in
>>>>> development
>>>>> version?
>>>>>
>>>>> We deploy javadocs for every official release and for the current
>>>>> SNAPSHOT. The Console can find the current version by calling
>>>>> Gremlin.version() - you should be able to use that to construct the
>>> right
>>>>> URL to the javadoc. I think that would work.
>>>>>
>>>>>
>>>>>
>>>>> On Mon, May 25, 2015 at 9:15 AM, Christos Oikonomou <
>>>> chrikon1994@gmail.com
>>>>>>
>>>>> wrote:
>>>>>
>>>>>> Hello everyone
>>>>>>
>>>>>> I was working on Java displaying in gremlin console.
>>>>>> I have came to a point that I need your guidance.
>>>>>> I have made 3 classes one for importing, for Doc structure in a
>> class
>>>> and
>>>>>> third for the structure of the data in a method.
>>>>>>
>>>>>> Also I add 2 commands in groovy the ImportDocsCommand and
>>> DicsCommand.
>>>>> The
>>>>>> first impliment the import of the javadocs of a class for the
>>>> Class.html
>>>>>> and the second the displaying.
>>>>>>
>>>>>> Firstly what are your thoughts for those,
>>>>>>
>>>>>> Secondly what is the correct path for the javadoc in release and in
>>>>>> development version?
>>>>>>
>>>>>> Regards
>>>>>> Christos
>>>>>>
>>>>>> On Sat, Apr 25, 2015 at 2:59 PM, Christos Oikonomou <
>>>>> chrikon1994@gmail.com
>>>>>>>
>>>>>> wrote:
>>>>>>
>>>>>>> I thought we can create an doc.xml with all the relative
>>> information
>>>>>>> gathered for every function.
>>>>>>>
>>>>>>> Although I see your point.
>>>>>>>
>>>>>>> But I like also the idea of Matt.....
>>>>>>>
>>>>>>> As I see this was something that interest you so I will start
>>> working
>>>>> on
>>>>>>> how that should be implemented.
>>>>>>>
>>>>>>> Regards,
>>>>>>> Christos
>>>>>>>
>>>>>>> On Sat, Apr 25, 2015 at 1:35 PM, Stephen Mallette <
>>>>> spmallette@gmail.com>
>>>>>>> wrote:
>>>>>>>
>>>>>>>> Matt, I like idea for a :docimport command. By default we would
>>>> load
>>>>>>>> GraphTraversal into it so that
>>>>>>>>
>>>>>>>> gremlin> :doc outE
>>>>>>>>
>>>>>>>> could resolve to the appropriate javadoc right out the box. It
>> is
>>>>>>>> generally applicable and as you say might even be of interest to
>>> the
>>>>>>>> groovy
>>>>>>>> project at some point.
>>>>>>>>
>>>>>>>> Christos, I think the categories you mention are good, but I
>> would
>>>>> take
>>>>>>>> care to consider the source of the documentation. Where would
>>> those
>>>>>>>> categories come from for you to display them? I don't think it
>>> would
>>>>> be
>>>>>>>> especially helpful if we had to manage javadoc, the asciidoc and
>>>> then
>>>>>>>> another class of documentation for the console. I think that
>>>>>> re-purposing
>>>>>>>> the javadoc is the best approach here and if we write some good
>>>>> javadoc
>>>>>> we
>>>>>>>> will roughly cover your categories. You could obviously display
>>> the
>>>>>> text
>>>>>>>> of the javadoc, which would likely cover your first two
>> categories
>>>> (if
>>>>>>>> written well). For the links, we could add @see tags as needed
>> to
>>>> the
>>>>>>>> javadoc and those would be the links to display in the console.
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>> On Fri, Apr 24, 2015 at 7:13 PM, Christos Oikonomou <
>>>>>>>> chrikon1994@gmail.com>
>>>>>>>> wrote:
>>>>>>>>
>>>>>>>>> I am glad for your reaction.
>>>>>>>>> I was thinking that we can display the information in 4
>>> categories
>>>>>>>>>
>>>>>>>>> gremlin> :doc foo
>>>>>>>>> Description of Functionality
>>>>>>>>> .....
>>>>>>>>> Some relevant functionalities
>>>>>>>>> ......
>>>>>>>>> Link to the user documentation
>>>>>>>>> ......
>>>>>>>>> Link to the javadoc
>>>>>>>>> .........
>>>>>>>>>
>>>>>>>>> Do you believe that informations will be clear to all kinds of
>>>> users
>>>>>>>>>
>>>>>>>>> On Sat, Apr 25, 2015 at 12:36 AM, Matt Frantz <
>>>>>>>> matthew.h.frantz@gmail.com>
>>>>>>>>> wrote:
>>>>>>>>>
>>>>>>>>>> Perhaps there should be a command to import the javadocs
>> for a
>>>>>>>> particular
>>>>>>>>>> package or interface, e.g. a DSL interface. The effect
>> would
>>> be
>>>>> to
>>>>>>>> haul
>>>>>>>>>> the methods into the global doc namespace. By default, we
>>> would
>>>>>> apply
>>>>>>>>> that
>>>>>>>>>> to GraphTraversal.
>>>>>>>>>>
>>>>>>>>>> gremlin> :doc outE
>>>>>>>>>> TODO: Write a good javadoc for each GraphTraversal method
>>>>>>>>>> gremlin> :importdoc TinkerFactory.SocialTraversal
>>>>>>>>>> gremlin> :doc people
>>>>>>>>>> TODO: Write a good javadoc for each SocialTraversal method
>>>>>>>>>>
>>>>>>>>>> It could be applied to any class or interface. Applying it
>>> to a
>>>>>>>> package
>>>>>>>>>> would haul the classes and subpackages into the global doc
>>>>>> namespace.
>>>>>>>>>>
>>>>>>>>>> gremlin> :importdoc
>>>>>> org.apache.tinkerpop.gremlin.tinkergraph.structure
>>>>>>>>>> gremlin> :doc TinkerHelper
>>>>>>>>>> gremlin> :doc TinkerHelper.queryVertexIndex
>>>>>>>>>>
>>>>>>>>>> Maybe you could allow fully-qualified resolution without an
>>>>> import:
>>>>>>>>>>
>>>>>>>>>> gremlin> :doc
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>
>>>>>>>>
>>>>>>
>>>>>
>>>>
>>>
>> org.apache.tinkerpop.gremlin.tinkergraph.structure.TinkerHelper.queryVertexIndex
>>>>>>>>>>
>>>>>>>>>> This seems like something that could be contributed upstream
>>> to
>>>>> the
>>>>>>>>> Groovy
>>>>>>>>>> REPL.
>>>>>>>>>>
>>>>>>>>>> On Fri, Apr 24, 2015 at 12:10 PM, Stephen Mallette <
>>>>>>>> spmallette@gmail.com
>>>>>>>>>>
>>>>>>>>>> wrote:
>>>>>>>>>>
>>>>>>>>>>> Yeah - it would be straightforward to bring in javadoc for
>>> the
>>>>>> most
>>>>>>>>> part:
>>>>>>>>>>>
>>>>>>>>>>> gremlin> :doc EdgeVertexStep
>>>>>>>>>>>
>>>>>>>>>>> you can get the class from that and full package name with
>>>>>>>> reflection
>>>>>>>>>> then
>>>>>>>>>>> translate it to javadoc to extract some text to display in
>>> the
>>>>>>>> console.
>>>>>>>>>> I
>>>>>>>>>>> guess that's nice, but no one knows VertexStep. They know
>>>> this
>>>>>> step
>>>>>>>>>>> though:
>>>>>>>>>>>
>>>>>>>>>>> gremlin> :doc outE
>>>>>>>>>>>
>>>>>>>>>>> So - I guess the question is how one would go from just a
>>> pure
>>>>>>>> javadoc
>>>>>>>>>>> lookup command (cool but a bit less useful to a first time
>>>> user
>>>>>> who
>>>>>>>>>> doesn't
>>>>>>>>>>> know the classes - not that EdgeVertexStep would yield
>>>> anything
>>>>>>>> about
>>>>>>>>>> outE
>>>>>>>>>>> for that matter as it sits) to something that gives the
>> user
>>>>>>>> content on
>>>>>>>>>>> steps from GraphTraversal which is the core of the DSL.
>> And
>>>>> then
>>>>>> -
>>>>>>>> how
>>>>>>>>>>> would it extend to other DSLs so that it was generally
>>>>> applicable
>>>>>> to
>>>>>>>>>> those
>>>>>>>>>>> extending the language.
>>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>> On Fri, Apr 24, 2015 at 3:02 PM, Marko Rodriguez <
>>>>>>>> okrammarko@gmail.com
>>>>>>>>>>
>>>>>>>>>>> wrote:
>>>>>>>>>>>
>>>>>>>>>>>> That would be really classy. It would be cool if that
>>> could
>>>> be
>>>>>>>> read
>>>>>>>>>> from
>>>>>>>>>>>> the JavaDoc somehow………… then we kill two birds with one
>>>> stone.
>>>>>>>>>>>>
>>>>>>>>>>>> Marko.
>>>>>>>>>>>>
>>>>>>>>>>>> http://markorodriguez.com
>>>>>>>>>>>>
>>>>>>>>>>>> On Apr 24, 2015, at 12:08 PM, Stephen Mallette <
>>>>>>>> spmallette@gmail.com
>>>>>>>>>>
>>>>>>>>>>>> wrote:
>>>>>>>>>>>>
>>>>>>>>>>>>>> A gremlin-command that display in gremlin-console
>> user
>>>>>>>>> documentation
>>>>>>>>>>> or
>>>>>>>>>>>>> javadocs of a gremlin functionality could be something
>>>> that
>>>>>>>> helps
>>>>>>>>>> user?
>>>>>>>>>>>>>
>>>>>>>>>>>>> That's an interesting idea. I assume you are
>> suggesting
>>>>>>>> something
>>>>>>>>>>> like:
>>>>>>>>>>>>>
>>>>>>>>>>>>> gremlin> :doc choose
>>>>>>>>>>>>> ==>The choose()-step (branch) routes the current
>>> traverser
>>>>> to
>>>>>> a
>>>>>>>>>>>> particular
>>>>>>>>>>>>> traversal branch option. With choose(), it is possible
>>> to
>>>>>>>>>>> implement......
>>>>>>>>>>>>>
>>>>>>>>>>>>> Is that what you mean?
>>>>>>>>>>>>>
>>>>>>>>>>>>>
>>>>>>>>>>>>>
>>>>>>>>>>>>>
>>>>>>>>>>>>> On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <
>>>>>>>>>>>> chrikon1994@gmail.com>
>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>
>>>>>>>>>>>>>> Hello and sorry for the delay. Thanks for the
>> answers.
>>>>>>>>>>>>>> I have done a general overview of all the code base.
>>> But
>>>>> more
>>>>>>>>>>>> familiarized
>>>>>>>>>>>>>> I am in gremlin-core and gremlin-console.
>>>>>>>>>>>>>> I prefer the assignment of issues because I wants to
>>> help
>>>>>> also
>>>>>>>> to
>>>>>>>>>> the
>>>>>>>>>>>>>> faster achievement of the project planning in
>> general.
>>>>>>>>>>>>>> Also I have an idea in documentation. A
>> gremlin-command
>>>>> that
>>>>>>>>> display
>>>>>>>>>>> in
>>>>>>>>>>>>>> gremlin-console user documentation or javadocs of a
>>>> gremlin
>>>>>>>>>>>> functionality
>>>>>>>>>>>>>> could be something that helps user?
>>>>>>>>>>>>>>
>>>>>>>>>>>>>> Regards,
>>>>>>>>>>>>>> Christos
>>>>>>>>>>>>>>
>>>>>>>>>>>>>> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <
>>>>>>>>>>>> m.ben.franklin@gmail.com>
>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <
>>>>>>>>>>> okrammarko@gmail.com>
>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> Hi Christos,
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> Given that you have familiarized yourself with the
>>>>>> codebase,
>>>>>>>>> which
>>>>>>>>>>>> area
>>>>>>>>>>>>>>> of
>>>>>>>>>>>>>>>> the codebase do you feel:
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> 1. you understand the best, and
>>>>>>>>>>>>>>>> 2. are interested in working on.
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> Given that information, I will be able to figure
>> out
>>>>>>>> something
>>>>>>>>>>>>>> particular
>>>>>>>>>>>>>>>> for you to do.
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> You should also feel free to pick an issue off of
>> JIRA
>>>>>>>> yourself,
>>>>>>>>> or
>>>>>>>>>>>> even
>>>>>>>>>>>>>>> create an issue and submit a patch for it.
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> Thanks,
>>>>>>>>>>>>>>>> Marko.
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> http://markorodriguez.com
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
>>>>>>>>>>>>>> chrikon1994@gmail.com>
>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>> Hello everyone,
>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>> I have read your advices how to start and how to
>> be
>>>>>>>>> familiarized
>>>>>>>>>>> with
>>>>>>>>>>>>>>> the
>>>>>>>>>>>>>>>>> codebase. After some time I spent exploring the
>>> code,
>>>> I
>>>>>>>>> believe I
>>>>>>>>>>> am
>>>>>>>>>>>>>>>> ready
>>>>>>>>>>>>>>>>> to start specific changes in the code.
>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>> So am sending this message to ask you, if some of
>>> you
>>>>> have
>>>>>>>>> ideas
>>>>>>>>>>>>>> about
>>>>>>>>>>>>>>>>> features or improvement and you want one more for
>>>> help.
>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>> Also if you have some issues you want some help
>>> please
>>>>> let
>>>>>>>> me
>>>>>>>>>> know
>>>>>>>>>>>>>>> (jira
>>>>>>>>>>>>>>>>> account chrikon).
>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>> Thanks in advance,
>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>> Regards
>>>>>>>>>>>>>>>>> Christos
>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos
>> Oikonomou
>>> <
>>>>>>>>>>>>>>>> chrikon1994@gmail.com>
>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>> Sorry Hadrian thank you for your correction, this
>>>> will
>>>>>> not
>>>>>>>>>> happen
>>>>>>>>>>>>>>> again!
>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea
>> <
>>>>>>>>>>>>>> hzbarcea@gmail.com>
>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>> Hi Christos,
>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>> First off, I am not a Mister :), just Hadrian.
>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>> Yes, the idea is to collaborate, that's what
>> open
>>>>> source
>>>>>>>> is
>>>>>>>>>>> about.
>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>> Good luck,
>>>>>>>>>>>>>>>>>>> Hadrian
>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou
>> wrote:
>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>> Firstly thank you all for your suggestions, all
>>> of
>>>>> them
>>>>>>>> are
>>>>>>>>>> very
>>>>>>>>>>>>>>>> helpful.
>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>> In this moment I follow the very good advice
>> and
>>> I
>>>> am
>>>>>>>>> reading
>>>>>>>>>>>>>>>>>>>> documentation, because next Wednesday I have to
>>>> make
>>>>> a
>>>>>>>>>>>>>> presentation
>>>>>>>>>>>>>>>> for
>>>>>>>>>>>>>>>>>>>> tinkerpop in front of my class!
>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>> Marko I have to write code for my assignment,
>> but
>>>> in
>>>>> my
>>>>>>>> free
>>>>>>>>>>> time
>>>>>>>>>>>>>> it
>>>>>>>>>>>>>>>> is
>>>>>>>>>>>>>>>>>>>> an
>>>>>>>>>>>>>>>>>>>> interesting work.
>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>> Although Javadoc it is applicable to my
>>>> assignment, I
>>>>>>>>> think. I
>>>>>>>>>>>>>> will
>>>>>>>>>>>>>>>> ask
>>>>>>>>>>>>>>>>>>>> and
>>>>>>>>>>>>>>>>>>>> I will have news.
>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>> If Mr. Hadrian Zbarcea are working on it, I
>> would
>>>>> like
>>>>>>>> not
>>>>>>>>> to
>>>>>>>>>>>>>>>> interfere
>>>>>>>>>>>>>>>>>>>> in
>>>>>>>>>>>>>>>>>>>> your job, or we can cooperate.
>>>>>>>>>>>>>>>>>>>> Before that discussion I have to contact to my
>>>>> academic
>>>>>>>>>>> supervisor
>>>>>>>>>>>>>>> in
>>>>>>>>>>>>>>>>>>>> order
>>>>>>>>>>>>>>>>>>>> to be 100% sure that this is ok.
>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>> P.S. I hope my English is at least
>>> understandable,
>>>> if
>>>>>>>> not so
>>>>>>>>>>>>>> please
>>>>>>>>>>>>>>>> ask
>>>>>>>>>>>>>>>>>>>> me
>>>>>>>>>>>>>>>>>>>> again.
>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>> Thank you all.
>>>>>>>>>>>>>>>>>>>> Christos
>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian
>> Zbarcea
>>> <
>>>>>>>>>>>>>>> hzbarcea@gmail.com>
>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>> That's something I am interested in too.
>>>>>>>>>>>>>>>>>>>>> Hadrian
>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>> Hi Christos,
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> Another thing that we need is more JavaDoc!
>> Its
>>>> not
>>>>>>>> sexy,
>>>>>>>>>> but
>>>>>>>>>>>>>> boy
>>>>>>>>>>>>>>>> would
>>>>>>>>>>>>>>>>>>>>>> be it be great to have someone go through and
>>>>>>>> JavaDoc-up
>>>>>>>>>>>>>>>> GraphTraversal
>>>>>>>>>>>>>>>>>>>>>> (all those methods…).
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
>>>>>>>>>>>>>>>>>>>>>>
>>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
>>>>>>>>>>>>>>>>>>>>>>
>>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> …the docs provide a description of each step.
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>> http://tinkerpop.incubator.apache.org/docs/3.0.0-
>>>>>>>>>>>>>>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct
>>>>> clicking
>>>>>> to
>>>>>>>>> any
>>>>>>>>>>>>>>>> particular
>>>>>>>>>>>>>>>>>>>>>> step)
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> I would say that would be more helpful now
>>> than a
>>>>>>>> "Through
>>>>>>>>>> the
>>>>>>>>>>>>>>>>>>>>>> TinkerPop"-tutorial.
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> Finally, what else would be helpful --- more
>>> test
>>>>>>>> cases.
>>>>>>>>> If
>>>>>>>>>>> you
>>>>>>>>>>>>>>> are
>>>>>>>>>>>>>>>>>>>>>> interested in testing, I can get your set up
>> in
>>>>> with
>>>>>> "a
>>>>>>>>>>> pattern"
>>>>>>>>>>>>>>> so
>>>>>>>>>>>>>>>>>>>>>> you pop
>>>>>>>>>>>>>>>>>>>>>> out more process/ tests. For example:
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
>>>>>>>>>>>>>>>>>>>>>>
>>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
>>>>>>>>>>>>>>>>>>>>>>
>>> gremlin/process/traversal/step/map/CountTest.java
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> Thanks,
>>>>>>>>>>>>>>>>>>>>>> Marko.
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> http://markorodriguez.com
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez
>> <
>>>>>>>>>>>>>>> okrammarko@gmail.com>
>>>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>> Hi Christos,
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>> Are you interested in writing code or
>> perhaps,
>>>>>>>> writing a
>>>>>>>>>>>>>>> tutorial?
>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>> It would be nice to have an in-depth
>> tutorial
>>> on
>>>>>>>>>> TinkerPop3.
>>>>>>>>>>>>>> For
>>>>>>>>>>>>>>>>>>>>>>> instance, find a reasonably sized dataset
>> (<1
>>>>>> million
>>>>>>>>>> edges),
>>>>>>>>>>>>>>> parse
>>>>>>>>>>>>>>>>>>>>>>> it into
>>>>>>>>>>>>>>>>>>>>>>> a graph, do some analysis on it, expose it
>> via
>>>>>> Gremlin
>>>>>>>>>>> Server,
>>>>>>>>>>>>>>> OLTP
>>>>>>>>>>>>>>>>>>>>>>> and
>>>>>>>>>>>>>>>>>>>>>>> OLAP queries hitting it, etc. Write up the
>>> path
>>>>> you
>>>>>>>> took
>>>>>>>>>> into
>>>>>>>>>>>>>> an
>>>>>>>>>>>>>>>>>>>>>>> AsciiDoc
>>>>>>>>>>>>>>>>>>>>>>> and we could put it on the Apache TinkerPop
>>> site
>>>>> as
>>>>>> a
>>>>>>>>>>> "Through
>>>>>>>>>>>>>>> the
>>>>>>>>>>>>>>>>>>>>>>> TinkerPop" tutorial. Be great if you could
>>> touch
>>>>> on
>>>>>>>> every
>>>>>>>>>>>>>> aspect
>>>>>>>>>>>>>>> of
>>>>>>>>>>>>>>>>>>>>>>> the
>>>>>>>>>>>>>>>>>>>>>>> TinkerPop framework in the tutorial.
>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>> I would appreciate a contribution like that.
>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>> Thanks,
>>>>>>>>>>>>>>>>>>>>>>> Marko.
>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>> http://markorodriguez.com
>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
>>>>>>>>>>>>>>>> m.ben.franklin@gmail.com>
>>>>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen
>>>> Mallette <
>>>>>>>>>>>>>>>>>>>>>>> spmallette@gmail.com>
>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>> My suggestion would be for you to spend
>> some
>>>> time
>>>>>>>>> learning
>>>>>>>>>>>>>>> about
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> TinkerPop
>>>>>>>>>>>>>>>>>>>>>>>>> (reading the documentation, examining the
>>> code
>>>>>> base,
>>>>>>>>>>> perusing
>>>>>>>>>>>>>>> the
>>>>>>>>>>>>>>>>>>>>>>>>> Jira
>>>>>>>>>>>>>>>>>>>>>>>>> issue tracker, etc.) to determine if any
>>>>>> particular
>>>>>>>>> part
>>>>>>>>>> of
>>>>>>>>>>>>>> the
>>>>>>>>>>>>>>>>>>>>>>>>> stack
>>>>>>>>>>>>>>>>>>>>>>>>> interests you.
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>> IMO, there is no better way to get involved
>>>> than
>>>>> to
>>>>>>>> pick
>>>>>>>>>>>>>>> something
>>>>>>>>>>>>>>>>>>>>>>>> that
>>>>>>>>>>>>>>>>>>>>>>>> needs to be worked on and provide a patch
>> for
>>>> it.
>>>>>> I
>>>>>>>>> would
>>>>>>>>>>>>>> look
>>>>>>>>>>>>>>> at
>>>>>>>>>>>>>>>>>>>>>>>> JIRA
>>>>>>>>>>>>>>>>>>>>>>>> and
>>>>>>>>>>>>>>>>>>>>>>>> find an issue that interests you.
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>> In doing that, you might develop your own
>>> ideas
>>>>> as
>>>>>> to
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> where/what you think you are best suited
>> to
>>>>>>>> contribute.
>>>>>>>>>> At
>>>>>>>>>>>>>>> that
>>>>>>>>>>>>>>>>>>>>>>>>> point
>>>>>>>>>>>>>>>>>>>>>>>>> you
>>>>>>>>>>>>>>>>>>>>>>>>> could post those ideas here in the mailing
>>>> list
>>>>>> for
>>>>>>>>>>> feedback.
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos
>>>>>> Oikonomou
>>>>>>>> <
>>>>>>>>>>>>>>>>>>>>>>>>> chrikon1994@gmail.com
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> Hi Stephen
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>> When I start I was not familiar with the
>>>>> project
>>>>>>>> nor
>>>>>>>>> the
>>>>>>>>>>>>>>>>>>>>>>>>>> architecture/codebase.
>>>>>>>>>>>>>>>>>>>>>>>>>> But I am reading about tinkerpop and
>>>> searching
>>>>> in
>>>>>>>> the
>>>>>>>>>> code
>>>>>>>>>>>>>> and
>>>>>>>>>>>>>>>>>>>>>>>>>> I am thinking to make some simple
>> examples
>>> in
>>>>>>>> order to
>>>>>>>>>> be
>>>>>>>>>>>>>> more
>>>>>>>>>>>>>>>>>>>>>>>>>> familiar
>>>>>>>>>>>>>>>>>>>>>>>>>> with the functionality.
>>>>>>>>>>>>>>>>>>>>>>>>>> So I am not now very familiar but I try
>> to
>>> be
>>>>> in
>>>>>>>> the
>>>>>>>>>> near
>>>>>>>>>>>>>>>> future.
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>> Christos
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen
>>>>>> Mallette <
>>>>>>>>>>>>>>>>>>>>>>>>>> spmallette@gmail.com>
>>>>>>>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>> Hi Christos, we appreciate your offer to
>>>>>>>> contribute.
>>>>>>>>>>> Could
>>>>>>>>>>>>>>> you
>>>>>>>>>>>>>>>>>>>>>>>>>> tell
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> us
>>>>>>>>>>>>>>>>>>>>>>>>>>> what kind of experience you have with
>>>>> TinkerPop
>>>>>> so
>>>>>>>>> far?
>>>>>>>>>>>>>> Are
>>>>>>>>>>>>>>>> you
>>>>>>>>>>>>>>>>>>>>>>>>>>> at
>>>>>>>>>>>>>>>>>>>>>>>>>>> all
>>>>>>>>>>>>>>>>>>>>>>>>>>> familiar with the architecture/codebase?
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> Stephen
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM,
>> Christos
>>>>>>>> Oikonomou
>>>>>>>>> <
>>>>>>>>>>>>>>>>>>>>>>>>>>> chrikon1994@gmail.com>
>>>>>>>>>>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> Dear Tinkerpop Development Team
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> My name is Christos Economou.
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> I would like to contribute in the
>>>> tinkerpop3.
>>>>>>>>>>>>>>>>>>>>>>>>>>>> This contribution will be a part of an
>>>>>>>> assignment in
>>>>>>>>>> one
>>>>>>>>>>>>>> of
>>>>>>>>>>>>>>> my
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> classes.
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>> I am in my third year of study at Athens
>>>>>>>> University of
>>>>>>>>>>>>>>> Economics
>>>>>>>>>>>>>>>>>>>>>>>>>>>> and
>>>>>>>>>>>>>>>>>>>>>>>>>>>> Business (Greece | Hellas).In this
>>>> semester I
>>>>>>>> attend
>>>>>>>>>> in
>>>>>>>>>>>>>>>> lectures
>>>>>>>>>>>>>>>>>>>>>>>>>>>> that
>>>>>>>>>>>>>>>>>>>>>>>>>>>> called "Advanced Topics in Software
>>>>>> Engineering"
>>>>>>>> by
>>>>>>>>>>>>>>> professor
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> Diomidis
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> Spinellis.
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> As assignment I have to contribute in
>> an
>>>> open
>>>>>>>> source
>>>>>>>>>>>>>>> project.
>>>>>>>>>>>>>>>> I
>>>>>>>>>>>>>>>>>>>>>>>>>>>> would
>>>>>>>>>>>>>>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3.
>> More
>>>>>>>>> specifically
>>>>>>>>>> I
>>>>>>>>>>>>>>>>>>>>>>>>>>>> understand
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> that
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> in
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> big projects, like this, always exists
>>> work
>>>> on
>>>>>>>>>>> integration
>>>>>>>>>>>>>>> and
>>>>>>>>>>>>>>>>>>>>>>>>>>>> collaboration between components and
>>>>>> subsystems.
>>>>>>>> So
>>>>>>>>> I
>>>>>>>>>> do
>>>>>>>>>>>>>> not
>>>>>>>>>>>>>>>> have
>>>>>>>>>>>>>>>>>>>>>>>>>>>> any
>>>>>>>>>>>>>>>>>>>>>>>>>>>> problem to work on that. But I am more
>>>>>>>> interested in
>>>>>>>>>>>>>>> creative
>>>>>>>>>>>>>>>>>>>>>>>>>>>> work
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> like
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> implementation of some algorithm or on a
>> new
>>>>>>>>>> functionality.
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> I have to mention I have a hard
>>> constraint,
>>>>>> that
>>>>>>>> my
>>>>>>>>>>>>>>>> contribution
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> should
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>> be
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> at least 100 - 200 lines of code.
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> So I am writing you to ask if you have
>> in
>>>>> mind
>>>>>>>> some
>>>>>>>>>>>>>>>>>>>>>>>>>>>> functionalities
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> that
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>> I
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> can help in development. Here some
>>>> information
>>>>>>>> about
>>>>>>>>> my
>>>>>>>>>>>>>>>>>>>>>>>>>>>> knowledge in
>>>>>>>>>>>>>>>>>>>>>>>>>>>> software engineering and programming
>>>>> languages
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>> http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> inetpub/detfolio/.
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>> Thank you for your time and attention.
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>> Regards,
>>>>>>>>>>>>>>>>>>>>>>>>>>>> Christos Oikonomou
>>>>>>>>>>>>>>>>>>>>>>>>>>>> Assistant researcher at ISTLab
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>> http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
>>>>>>>>>>>>>>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>
>>>>>>>>>>>>
>>>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>
>>>>>
>>>>
>>>
>>
Re: Contributing to tinkerpop3
Posted by Stephen Mallette <sp...@gmail.com>.
The screenshot you provided on the PR looks pretty cool! We'll take a look
at it in more detail...thanks.
On Mon, Jun 8, 2015 at 4:51 AM, Christos Oikonomou <ch...@gmail.com>
wrote:
> Hello everyone,
>
> I have finished my work on commands and I have done a pull request
> yesterday!
> (The checking with travis BI will be done when my request is overviewed for
> the pull request or I should do it myself?)
>
> If you have some time review my submission for feedback and corrections.
>
> Thank you for your time anyway
>
> Regards,
> Christos
>
> On Tue, May 26, 2015 at 6:14 PM, Stephen Mallette <sp...@gmail.com>
> wrote:
>
> > I'd forgotten that we package the javadoc with the zip. I think that
> makes
> > sense. Feel free to share the link to your fork (and more information
> > about your design, like how the commands work) when you are ready,
> however
> > the earlier you get feedback the more helpful it might be to you.
> >
> > On Tue, May 26, 2015 at 10:05 AM, Christos Oikonomou <
> > chrikon1994@gmail.com>
> > wrote:
> >
> > > Hello Stephen,
> > > I thought that it would be better to avoid reading url if we provide
> the
> > > .html in the release zip.
> > > That's why I thought to create two methods to read the javadocs locally
> > > (why I need the path) or if that fails to go to url. I f you believe
> that
> > > is not necessary this works fine for me also because it is a lot of
> work.
> > > But this operation will not work off line.
> > > For the repo yes I have one folk but I have not finnish all the
> > > documentation and junit so I have not push yet, when I do I will send
> you
> > > the link.
> > > Regards,
> > > Christos
> > >
> > > On Tue, May 26, 2015 at 2:44 PM, Stephen Mallette <
> spmallette@gmail.com>
> > > wrote:
> > >
> > > > Hi Christos - I assume that you have a fork of TinkerPop3 somewhere?
> > > > Perhaps you could point us to your code so that we can see what
> you've
> > > > done? It might be easier to discuss if we could see that. Also, it
> > > would
> > > > be helpful to know more about your proposed syntax to your commands
> and
> > > > what they will do.
> > > >
> > > > > Secondly what is the correct path for the javadoc in release and in
> > > > development
> > > > version?
> > > >
> > > > We deploy javadocs for every official release and for the current
> > > > SNAPSHOT. The Console can find the current version by calling
> > > > Gremlin.version() - you should be able to use that to construct the
> > right
> > > > URL to the javadoc. I think that would work.
> > > >
> > > >
> > > >
> > > > On Mon, May 25, 2015 at 9:15 AM, Christos Oikonomou <
> > > chrikon1994@gmail.com
> > > > >
> > > > wrote:
> > > >
> > > > > Hello everyone
> > > > >
> > > > > I was working on Java displaying in gremlin console.
> > > > > I have came to a point that I need your guidance.
> > > > > I have made 3 classes one for importing, for Doc structure in a
> class
> > > and
> > > > > third for the structure of the data in a method.
> > > > >
> > > > > Also I add 2 commands in groovy the ImportDocsCommand and
> > DicsCommand.
> > > > The
> > > > > first impliment the import of the javadocs of a class for the
> > > Class.html
> > > > > and the second the displaying.
> > > > >
> > > > > Firstly what are your thoughts for those,
> > > > >
> > > > > Secondly what is the correct path for the javadoc in release and in
> > > > > development version?
> > > > >
> > > > > Regards
> > > > > Christos
> > > > >
> > > > > On Sat, Apr 25, 2015 at 2:59 PM, Christos Oikonomou <
> > > > chrikon1994@gmail.com
> > > > > >
> > > > > wrote:
> > > > >
> > > > > > I thought we can create an doc.xml with all the relative
> > information
> > > > > > gathered for every function.
> > > > > >
> > > > > > Although I see your point.
> > > > > >
> > > > > > But I like also the idea of Matt.....
> > > > > >
> > > > > > As I see this was something that interest you so I will start
> > working
> > > > on
> > > > > > how that should be implemented.
> > > > > >
> > > > > > Regards,
> > > > > > Christos
> > > > > >
> > > > > > On Sat, Apr 25, 2015 at 1:35 PM, Stephen Mallette <
> > > > spmallette@gmail.com>
> > > > > > wrote:
> > > > > >
> > > > > >> Matt, I like idea for a :docimport command. By default we would
> > > load
> > > > > >> GraphTraversal into it so that
> > > > > >>
> > > > > >> gremlin> :doc outE
> > > > > >>
> > > > > >> could resolve to the appropriate javadoc right out the box. It
> is
> > > > > >> generally applicable and as you say might even be of interest to
> > the
> > > > > >> groovy
> > > > > >> project at some point.
> > > > > >>
> > > > > >> Christos, I think the categories you mention are good, but I
> would
> > > > take
> > > > > >> care to consider the source of the documentation. Where would
> > those
> > > > > >> categories come from for you to display them? I don't think it
> > would
> > > > be
> > > > > >> especially helpful if we had to manage javadoc, the asciidoc and
> > > then
> > > > > >> another class of documentation for the console. I think that
> > > > > re-purposing
> > > > > >> the javadoc is the best approach here and if we write some good
> > > > javadoc
> > > > > we
> > > > > >> will roughly cover your categories. You could obviously display
> > the
> > > > > text
> > > > > >> of the javadoc, which would likely cover your first two
> categories
> > > (if
> > > > > >> written well). For the links, we could add @see tags as needed
> to
> > > the
> > > > > >> javadoc and those would be the links to display in the console.
> > > > > >>
> > > > > >>
> > > > > >>
> > > > > >>
> > > > > >>
> > > > > >> On Fri, Apr 24, 2015 at 7:13 PM, Christos Oikonomou <
> > > > > >> chrikon1994@gmail.com>
> > > > > >> wrote:
> > > > > >>
> > > > > >> > I am glad for your reaction.
> > > > > >> > I was thinking that we can display the information in 4
> > categories
> > > > > >> >
> > > > > >> > gremlin> :doc foo
> > > > > >> > Description of Functionality
> > > > > >> > .....
> > > > > >> > Some relevant functionalities
> > > > > >> > ......
> > > > > >> > Link to the user documentation
> > > > > >> > ......
> > > > > >> > Link to the javadoc
> > > > > >> > .........
> > > > > >> >
> > > > > >> > Do you believe that informations will be clear to all kinds of
> > > users
> > > > > >> >
> > > > > >> > On Sat, Apr 25, 2015 at 12:36 AM, Matt Frantz <
> > > > > >> matthew.h.frantz@gmail.com>
> > > > > >> > wrote:
> > > > > >> >
> > > > > >> > > Perhaps there should be a command to import the javadocs
> for a
> > > > > >> particular
> > > > > >> > > package or interface, e.g. a DSL interface. The effect
> would
> > be
> > > > to
> > > > > >> haul
> > > > > >> > > the methods into the global doc namespace. By default, we
> > would
> > > > > apply
> > > > > >> > that
> > > > > >> > > to GraphTraversal.
> > > > > >> > >
> > > > > >> > > gremlin> :doc outE
> > > > > >> > > TODO: Write a good javadoc for each GraphTraversal method
> > > > > >> > > gremlin> :importdoc TinkerFactory.SocialTraversal
> > > > > >> > > gremlin> :doc people
> > > > > >> > > TODO: Write a good javadoc for each SocialTraversal method
> > > > > >> > >
> > > > > >> > > It could be applied to any class or interface. Applying it
> > to a
> > > > > >> package
> > > > > >> > > would haul the classes and subpackages into the global doc
> > > > > namespace.
> > > > > >> > >
> > > > > >> > > gremlin> :importdoc
> > > > > org.apache.tinkerpop.gremlin.tinkergraph.structure
> > > > > >> > > gremlin> :doc TinkerHelper
> > > > > >> > > gremlin> :doc TinkerHelper.queryVertexIndex
> > > > > >> > >
> > > > > >> > > Maybe you could allow fully-qualified resolution without an
> > > > import:
> > > > > >> > >
> > > > > >> > > gremlin> :doc
> > > > > >> > >
> > > > > >> > >
> > > > > >> >
> > > > > >>
> > > > >
> > > >
> > >
> >
> org.apache.tinkerpop.gremlin.tinkergraph.structure.TinkerHelper.queryVertexIndex
> > > > > >> > >
> > > > > >> > > This seems like something that could be contributed upstream
> > to
> > > > the
> > > > > >> > Groovy
> > > > > >> > > REPL.
> > > > > >> > >
> > > > > >> > > On Fri, Apr 24, 2015 at 12:10 PM, Stephen Mallette <
> > > > > >> spmallette@gmail.com
> > > > > >> > >
> > > > > >> > > wrote:
> > > > > >> > >
> > > > > >> > > > Yeah - it would be straightforward to bring in javadoc for
> > the
> > > > > most
> > > > > >> > part:
> > > > > >> > > >
> > > > > >> > > > gremlin> :doc EdgeVertexStep
> > > > > >> > > >
> > > > > >> > > > you can get the class from that and full package name with
> > > > > >> reflection
> > > > > >> > > then
> > > > > >> > > > translate it to javadoc to extract some text to display in
> > the
> > > > > >> console.
> > > > > >> > > I
> > > > > >> > > > guess that's nice, but no one knows VertexStep. They know
> > > this
> > > > > step
> > > > > >> > > > though:
> > > > > >> > > >
> > > > > >> > > > gremlin> :doc outE
> > > > > >> > > >
> > > > > >> > > > So - I guess the question is how one would go from just a
> > pure
> > > > > >> javadoc
> > > > > >> > > > lookup command (cool but a bit less useful to a first time
> > > user
> > > > > who
> > > > > >> > > doesn't
> > > > > >> > > > know the classes - not that EdgeVertexStep would yield
> > > anything
> > > > > >> about
> > > > > >> > > outE
> > > > > >> > > > for that matter as it sits) to something that gives the
> user
> > > > > >> content on
> > > > > >> > > > steps from GraphTraversal which is the core of the DSL.
> And
> > > > then
> > > > > -
> > > > > >> how
> > > > > >> > > > would it extend to other DSLs so that it was generally
> > > > applicable
> > > > > to
> > > > > >> > > those
> > > > > >> > > > extending the language.
> > > > > >> > > >
> > > > > >> > > >
> > > > > >> > > >
> > > > > >> > > > On Fri, Apr 24, 2015 at 3:02 PM, Marko Rodriguez <
> > > > > >> okrammarko@gmail.com
> > > > > >> > >
> > > > > >> > > > wrote:
> > > > > >> > > >
> > > > > >> > > > > That would be really classy. It would be cool if that
> > could
> > > be
> > > > > >> read
> > > > > >> > > from
> > > > > >> > > > > the JavaDoc somehow………… then we kill two birds with one
> > > stone.
> > > > > >> > > > >
> > > > > >> > > > > Marko.
> > > > > >> > > > >
> > > > > >> > > > > http://markorodriguez.com
> > > > > >> > > > >
> > > > > >> > > > > On Apr 24, 2015, at 12:08 PM, Stephen Mallette <
> > > > > >> spmallette@gmail.com
> > > > > >> > >
> > > > > >> > > > > wrote:
> > > > > >> > > > >
> > > > > >> > > > > >> A gremlin-command that display in gremlin-console
> user
> > > > > >> > documentation
> > > > > >> > > > or
> > > > > >> > > > > > javadocs of a gremlin functionality could be something
> > > that
> > > > > >> helps
> > > > > >> > > user?
> > > > > >> > > > > >
> > > > > >> > > > > > That's an interesting idea. I assume you are
> suggesting
> > > > > >> something
> > > > > >> > > > like:
> > > > > >> > > > > >
> > > > > >> > > > > > gremlin> :doc choose
> > > > > >> > > > > > ==>The choose()-step (branch) routes the current
> > traverser
> > > > to
> > > > > a
> > > > > >> > > > > particular
> > > > > >> > > > > > traversal branch option. With choose(), it is possible
> > to
> > > > > >> > > > implement......
> > > > > >> > > > > >
> > > > > >> > > > > > Is that what you mean?
> > > > > >> > > > > >
> > > > > >> > > > > >
> > > > > >> > > > > >
> > > > > >> > > > > >
> > > > > >> > > > > > On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <
> > > > > >> > > > > chrikon1994@gmail.com>
> > > > > >> > > > > > wrote:
> > > > > >> > > > > >
> > > > > >> > > > > >> Hello and sorry for the delay. Thanks for the
> answers.
> > > > > >> > > > > >> I have done a general overview of all the code base.
> > But
> > > > more
> > > > > >> > > > > familiarized
> > > > > >> > > > > >> I am in gremlin-core and gremlin-console.
> > > > > >> > > > > >> I prefer the assignment of issues because I wants to
> > help
> > > > > also
> > > > > >> to
> > > > > >> > > the
> > > > > >> > > > > >> faster achievement of the project planning in
> general.
> > > > > >> > > > > >> Also I have an idea in documentation. A
> gremlin-command
> > > > that
> > > > > >> > display
> > > > > >> > > > in
> > > > > >> > > > > >> gremlin-console user documentation or javadocs of a
> > > gremlin
> > > > > >> > > > > functionality
> > > > > >> > > > > >> could be something that helps user?
> > > > > >> > > > > >>
> > > > > >> > > > > >> Regards,
> > > > > >> > > > > >> Christos
> > > > > >> > > > > >>
> > > > > >> > > > > >> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <
> > > > > >> > > > > m.ben.franklin@gmail.com>
> > > > > >> > > > > >> wrote:
> > > > > >> > > > > >>
> > > > > >> > > > > >>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <
> > > > > >> > > > okrammarko@gmail.com>
> > > > > >> > > > > >>> wrote:
> > > > > >> > > > > >>>
> > > > > >> > > > > >>>> Hi Christos,
> > > > > >> > > > > >>>>
> > > > > >> > > > > >>>> Given that you have familiarized yourself with the
> > > > > codebase,
> > > > > >> > which
> > > > > >> > > > > area
> > > > > >> > > > > >>> of
> > > > > >> > > > > >>>> the codebase do you feel:
> > > > > >> > > > > >>>>
> > > > > >> > > > > >>>> 1. you understand the best, and
> > > > > >> > > > > >>>> 2. are interested in working on.
> > > > > >> > > > > >>>>
> > > > > >> > > > > >>>> Given that information, I will be able to figure
> out
> > > > > >> something
> > > > > >> > > > > >> particular
> > > > > >> > > > > >>>> for you to do.
> > > > > >> > > > > >>>>
> > > > > >> > > > > >>>
> > > > > >> > > > > >>> You should also feel free to pick an issue off of
> JIRA
> > > > > >> yourself,
> > > > > >> > or
> > > > > >> > > > > even
> > > > > >> > > > > >>> create an issue and submit a patch for it.
> > > > > >> > > > > >>>
> > > > > >> > > > > >>>
> > > > > >> > > > > >>>>
> > > > > >> > > > > >>>> Thanks,
> > > > > >> > > > > >>>> Marko.
> > > > > >> > > > > >>>>
> > > > > >> > > > > >>>> http://markorodriguez.com
> > > > > >> > > > > >>>>
> > > > > >> > > > > >>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
> > > > > >> > > > > >> chrikon1994@gmail.com>
> > > > > >> > > > > >>>> wrote:
> > > > > >> > > > > >>>>
> > > > > >> > > > > >>>>> Hello everyone,
> > > > > >> > > > > >>>>>
> > > > > >> > > > > >>>>> I have read your advices how to start and how to
> be
> > > > > >> > familiarized
> > > > > >> > > > with
> > > > > >> > > > > >>> the
> > > > > >> > > > > >>>>> codebase. After some time I spent exploring the
> > code,
> > > I
> > > > > >> > believe I
> > > > > >> > > > am
> > > > > >> > > > > >>>> ready
> > > > > >> > > > > >>>>> to start specific changes in the code.
> > > > > >> > > > > >>>>>
> > > > > >> > > > > >>>>> So am sending this message to ask you, if some of
> > you
> > > > have
> > > > > >> > ideas
> > > > > >> > > > > >> about
> > > > > >> > > > > >>>>> features or improvement and you want one more for
> > > help.
> > > > > >> > > > > >>>>>
> > > > > >> > > > > >>>>> Also if you have some issues you want some help
> > please
> > > > let
> > > > > >> me
> > > > > >> > > know
> > > > > >> > > > > >>> (jira
> > > > > >> > > > > >>>>> account chrikon).
> > > > > >> > > > > >>>>>
> > > > > >> > > > > >>>>> Thanks in advance,
> > > > > >> > > > > >>>>>
> > > > > >> > > > > >>>>> Regards
> > > > > >> > > > > >>>>> Christos
> > > > > >> > > > > >>>>>
> > > > > >> > > > > >>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos
> Oikonomou
> > <
> > > > > >> > > > > >>>> chrikon1994@gmail.com>
> > > > > >> > > > > >>>>> wrote:
> > > > > >> > > > > >>>>>
> > > > > >> > > > > >>>>>> Sorry Hadrian thank you for your correction, this
> > > will
> > > > > not
> > > > > >> > > happen
> > > > > >> > > > > >>> again!
> > > > > >> > > > > >>>>>>
> > > > > >> > > > > >>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea
> <
> > > > > >> > > > > >> hzbarcea@gmail.com>
> > > > > >> > > > > >>>>>> wrote:
> > > > > >> > > > > >>>>>>
> > > > > >> > > > > >>>>>>> Hi Christos,
> > > > > >> > > > > >>>>>>>
> > > > > >> > > > > >>>>>>> First off, I am not a Mister :), just Hadrian.
> > > > > >> > > > > >>>>>>>
> > > > > >> > > > > >>>>>>> Yes, the idea is to collaborate, that's what
> open
> > > > source
> > > > > >> is
> > > > > >> > > > about.
> > > > > >> > > > > >>>>>>>
> > > > > >> > > > > >>>>>>> Good luck,
> > > > > >> > > > > >>>>>>> Hadrian
> > > > > >> > > > > >>>>>>>
> > > > > >> > > > > >>>>>>>
> > > > > >> > > > > >>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou
> wrote:
> > > > > >> > > > > >>>>>>>
> > > > > >> > > > > >>>>>>>> Firstly thank you all for your suggestions, all
> > of
> > > > them
> > > > > >> are
> > > > > >> > > very
> > > > > >> > > > > >>>> helpful.
> > > > > >> > > > > >>>>>>>>
> > > > > >> > > > > >>>>>>>> In this moment I follow the very good advice
> and
> > I
> > > am
> > > > > >> > reading
> > > > > >> > > > > >>>>>>>> documentation, because next Wednesday I have to
> > > make
> > > > a
> > > > > >> > > > > >> presentation
> > > > > >> > > > > >>>> for
> > > > > >> > > > > >>>>>>>> tinkerpop in front of my class!
> > > > > >> > > > > >>>>>>>>
> > > > > >> > > > > >>>>>>>> Marko I have to write code for my assignment,
> but
> > > in
> > > > my
> > > > > >> free
> > > > > >> > > > time
> > > > > >> > > > > >> it
> > > > > >> > > > > >>>> is
> > > > > >> > > > > >>>>>>>> an
> > > > > >> > > > > >>>>>>>> interesting work.
> > > > > >> > > > > >>>>>>>>
> > > > > >> > > > > >>>>>>>> Although Javadoc it is applicable to my
> > > assignment, I
> > > > > >> > think. I
> > > > > >> > > > > >> will
> > > > > >> > > > > >>>> ask
> > > > > >> > > > > >>>>>>>> and
> > > > > >> > > > > >>>>>>>> I will have news.
> > > > > >> > > > > >>>>>>>>
> > > > > >> > > > > >>>>>>>> If Mr. Hadrian Zbarcea are working on it, I
> would
> > > > like
> > > > > >> not
> > > > > >> > to
> > > > > >> > > > > >>>> interfere
> > > > > >> > > > > >>>>>>>> in
> > > > > >> > > > > >>>>>>>> your job, or we can cooperate.
> > > > > >> > > > > >>>>>>>> Before that discussion I have to contact to my
> > > > academic
> > > > > >> > > > supervisor
> > > > > >> > > > > >>> in
> > > > > >> > > > > >>>>>>>> order
> > > > > >> > > > > >>>>>>>> to be 100% sure that this is ok.
> > > > > >> > > > > >>>>>>>>
> > > > > >> > > > > >>>>>>>> P.S. I hope my English is at least
> > understandable,
> > > if
> > > > > >> not so
> > > > > >> > > > > >> please
> > > > > >> > > > > >>>> ask
> > > > > >> > > > > >>>>>>>> me
> > > > > >> > > > > >>>>>>>> again.
> > > > > >> > > > > >>>>>>>>
> > > > > >> > > > > >>>>>>>> Thank you all.
> > > > > >> > > > > >>>>>>>> Christos
> > > > > >> > > > > >>>>>>>>
> > > > > >> > > > > >>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian
> Zbarcea
> > <
> > > > > >> > > > > >>> hzbarcea@gmail.com>
> > > > > >> > > > > >>>>>>>> wrote:
> > > > > >> > > > > >>>>>>>>
> > > > > >> > > > > >>>>>>>> That's something I am interested in too.
> > > > > >> > > > > >>>>>>>>> Hadrian
> > > > > >> > > > > >>>>>>>>>
> > > > > >> > > > > >>>>>>>>>
> > > > > >> > > > > >>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
> > > > > >> > > > > >>>>>>>>>
> > > > > >> > > > > >>>>>>>>> Hi Christos,
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>> Another thing that we need is more JavaDoc!
> Its
> > > not
> > > > > >> sexy,
> > > > > >> > > but
> > > > > >> > > > > >> boy
> > > > > >> > > > > >>>> would
> > > > > >> > > > > >>>>>>>>>> be it be great to have someone go through and
> > > > > >> JavaDoc-up
> > > > > >> > > > > >>>> GraphTraversal
> > > > > >> > > > > >>>>>>>>>> (all those methods…).
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > https://github.com/apache/incubator-tinkerpop/blob/
> > > > > >> > > > > >>>>>>>>>>
> > > > > master/gremlin-core/src/main/java/org/apache/tinkerpop/
> > > > > >> > > > > >>>>>>>>>>
> > > > > gremlin/process/traversal/dsl/graph/GraphTraversal.java
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>> …the docs provide a description of each step.
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> http://tinkerpop.incubator.apache.org/docs/3.0.0-
> > > > > >> > > > > >>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct
> > > > clicking
> > > > > to
> > > > > >> > any
> > > > > >> > > > > >>>> particular
> > > > > >> > > > > >>>>>>>>>> step)
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>> I would say that would be more helpful now
> > than a
> > > > > >> "Through
> > > > > >> > > the
> > > > > >> > > > > >>>>>>>>>> TinkerPop"-tutorial.
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>> Finally, what else would be helpful --- more
> > test
> > > > > >> cases.
> > > > > >> > If
> > > > > >> > > > you
> > > > > >> > > > > >>> are
> > > > > >> > > > > >>>>>>>>>> interested in testing, I can get your set up
> in
> > > > with
> > > > > "a
> > > > > >> > > > pattern"
> > > > > >> > > > > >>> so
> > > > > >> > > > > >>>>>>>>>> you pop
> > > > > >> > > > > >>>>>>>>>> out more process/ tests. For example:
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > https://github.com/apache/incubator-tinkerpop/blob/
> > > > > >> > > > > >>>>>>>>>>
> > > > > master/gremlin-test/src/main/java/org/apache/tinkerpop/
> > > > > >> > > > > >>>>>>>>>>
> > gremlin/process/traversal/step/map/CountTest.java
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>> Thanks,
> > > > > >> > > > > >>>>>>>>>> Marko.
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>> http://markorodriguez.com
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez
> <
> > > > > >> > > > > >>> okrammarko@gmail.com>
> > > > > >> > > > > >>>>>>>>>> wrote:
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>> Hi Christos,
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>> Are you interested in writing code or
> perhaps,
> > > > > >> writing a
> > > > > >> > > > > >>> tutorial?
> > > > > >> > > > > >>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>> It would be nice to have an in-depth
> tutorial
> > on
> > > > > >> > > TinkerPop3.
> > > > > >> > > > > >> For
> > > > > >> > > > > >>>>>>>>>>> instance, find a reasonably sized dataset
> (<1
> > > > > million
> > > > > >> > > edges),
> > > > > >> > > > > >>> parse
> > > > > >> > > > > >>>>>>>>>>> it into
> > > > > >> > > > > >>>>>>>>>>> a graph, do some analysis on it, expose it
> via
> > > > > Gremlin
> > > > > >> > > > Server,
> > > > > >> > > > > >>> OLTP
> > > > > >> > > > > >>>>>>>>>>> and
> > > > > >> > > > > >>>>>>>>>>> OLAP queries hitting it, etc. Write up the
> > path
> > > > you
> > > > > >> took
> > > > > >> > > into
> > > > > >> > > > > >> an
> > > > > >> > > > > >>>>>>>>>>> AsciiDoc
> > > > > >> > > > > >>>>>>>>>>> and we could put it on the Apache TinkerPop
> > site
> > > > as
> > > > > a
> > > > > >> > > > "Through
> > > > > >> > > > > >>> the
> > > > > >> > > > > >>>>>>>>>>> TinkerPop" tutorial. Be great if you could
> > touch
> > > > on
> > > > > >> every
> > > > > >> > > > > >> aspect
> > > > > >> > > > > >>> of
> > > > > >> > > > > >>>>>>>>>>> the
> > > > > >> > > > > >>>>>>>>>>> TinkerPop framework in the tutorial.
> > > > > >> > > > > >>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>> I would appreciate a contribution like that.
> > > > > >> > > > > >>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>> Thanks,
> > > > > >> > > > > >>>>>>>>>>> Marko.
> > > > > >> > > > > >>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>> http://markorodriguez.com
> > > > > >> > > > > >>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
> > > > > >> > > > > >>>> m.ben.franklin@gmail.com>
> > > > > >> > > > > >>>>>>>>>>> wrote:
> > > > > >> > > > > >>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen
> > > Mallette <
> > > > > >> > > > > >>>>>>>>>>> spmallette@gmail.com>
> > > > > >> > > > > >>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>> wrote:
> > > > > >> > > > > >>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>> My suggestion would be for you to spend
> some
> > > time
> > > > > >> > learning
> > > > > >> > > > > >>> about
> > > > > >> > > > > >>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>> TinkerPop
> > > > > >> > > > > >>>>>>>>>>>>> (reading the documentation, examining the
> > code
> > > > > base,
> > > > > >> > > > perusing
> > > > > >> > > > > >>> the
> > > > > >> > > > > >>>>>>>>>>>>> Jira
> > > > > >> > > > > >>>>>>>>>>>>> issue tracker, etc.) to determine if any
> > > > > particular
> > > > > >> > part
> > > > > >> > > of
> > > > > >> > > > > >> the
> > > > > >> > > > > >>>>>>>>>>>>> stack
> > > > > >> > > > > >>>>>>>>>>>>> interests you.
> > > > > >> > > > > >>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>> IMO, there is no better way to get involved
> > > than
> > > > to
> > > > > >> pick
> > > > > >> > > > > >>> something
> > > > > >> > > > > >>>>>>>>>>>> that
> > > > > >> > > > > >>>>>>>>>>>> needs to be worked on and provide a patch
> for
> > > it.
> > > > > I
> > > > > >> > would
> > > > > >> > > > > >> look
> > > > > >> > > > > >>> at
> > > > > >> > > > > >>>>>>>>>>>> JIRA
> > > > > >> > > > > >>>>>>>>>>>> and
> > > > > >> > > > > >>>>>>>>>>>> find an issue that interests you.
> > > > > >> > > > > >>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>> In doing that, you might develop your own
> > ideas
> > > > as
> > > > > to
> > > > > >> > > > > >>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>> where/what you think you are best suited
> to
> > > > > >> contribute.
> > > > > >> > > At
> > > > > >> > > > > >>> that
> > > > > >> > > > > >>>>>>>>>>>>> point
> > > > > >> > > > > >>>>>>>>>>>>> you
> > > > > >> > > > > >>>>>>>>>>>>> could post those ideas here in the mailing
> > > list
> > > > > for
> > > > > >> > > > feedback.
> > > > > >> > > > > >>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos
> > > > > Oikonomou
> > > > > >> <
> > > > > >> > > > > >>>>>>>>>>>>> chrikon1994@gmail.com
> > > > > >> > > > > >>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>> wrote:
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>> Hi Stephen
> > > > > >> > > > > >>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>> When I start I was not familiar with the
> > > > project
> > > > > >> nor
> > > > > >> > the
> > > > > >> > > > > >>>>>>>>>>>>>> architecture/codebase.
> > > > > >> > > > > >>>>>>>>>>>>>> But I am reading about tinkerpop and
> > > searching
> > > > in
> > > > > >> the
> > > > > >> > > code
> > > > > >> > > > > >> and
> > > > > >> > > > > >>>>>>>>>>>>>> I am thinking to make some simple
> examples
> > in
> > > > > >> order to
> > > > > >> > > be
> > > > > >> > > > > >> more
> > > > > >> > > > > >>>>>>>>>>>>>> familiar
> > > > > >> > > > > >>>>>>>>>>>>>> with the functionality.
> > > > > >> > > > > >>>>>>>>>>>>>> So I am not now very familiar but I try
> to
> > be
> > > > in
> > > > > >> the
> > > > > >> > > near
> > > > > >> > > > > >>>> future.
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>> Christos
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen
> > > > > Mallette <
> > > > > >> > > > > >>>>>>>>>>>>>> spmallette@gmail.com>
> > > > > >> > > > > >>>>>>>>>>>>>> wrote:
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>> Hi Christos, we appreciate your offer to
> > > > > >> contribute.
> > > > > >> > > > Could
> > > > > >> > > > > >>> you
> > > > > >> > > > > >>>>>>>>>>>>>> tell
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>> us
> > > > > >> > > > > >>>>>>>>>>>>>>> what kind of experience you have with
> > > > TinkerPop
> > > > > so
> > > > > >> > far?
> > > > > >> > > > > >> Are
> > > > > >> > > > > >>>> you
> > > > > >> > > > > >>>>>>>>>>>>>>> at
> > > > > >> > > > > >>>>>>>>>>>>>>> all
> > > > > >> > > > > >>>>>>>>>>>>>>> familiar with the architecture/codebase?
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>> Stephen
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM,
> Christos
> > > > > >> Oikonomou
> > > > > >> > <
> > > > > >> > > > > >>>>>>>>>>>>>>> chrikon1994@gmail.com>
> > > > > >> > > > > >>>>>>>>>>>>>>> wrote:
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>> Dear Tinkerpop Development Team
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>> My name is Christos Economou.
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>> I would like to contribute in the
> > > tinkerpop3.
> > > > > >> > > > > >>>>>>>>>>>>>>>> This contribution will be a part of an
> > > > > >> assignment in
> > > > > >> > > one
> > > > > >> > > > > >> of
> > > > > >> > > > > >>> my
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>> classes.
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>> I am in my third year of study at Athens
> > > > > >> University of
> > > > > >> > > > > >>> Economics
> > > > > >> > > > > >>>>>>>>>>>>>>>> and
> > > > > >> > > > > >>>>>>>>>>>>>>>> Business (Greece | Hellas).In this
> > > semester I
> > > > > >> attend
> > > > > >> > > in
> > > > > >> > > > > >>>> lectures
> > > > > >> > > > > >>>>>>>>>>>>>>>> that
> > > > > >> > > > > >>>>>>>>>>>>>>>> called "Advanced Topics in Software
> > > > > Engineering"
> > > > > >> by
> > > > > >> > > > > >>> professor
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>> Diomidis
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>> Spinellis.
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>> As assignment I have to contribute in
> an
> > > open
> > > > > >> source
> > > > > >> > > > > >>> project.
> > > > > >> > > > > >>>> I
> > > > > >> > > > > >>>>>>>>>>>>>>>> would
> > > > > >> > > > > >>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3.
> More
> > > > > >> > specifically
> > > > > >> > > I
> > > > > >> > > > > >>>>>>>>>>>>>>>> understand
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>> that
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>> in
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>> big projects, like this, always exists
> > work
> > > on
> > > > > >> > > > integration
> > > > > >> > > > > >>> and
> > > > > >> > > > > >>>>>>>>>>>>>>>> collaboration between components and
> > > > > subsystems.
> > > > > >> So
> > > > > >> > I
> > > > > >> > > do
> > > > > >> > > > > >> not
> > > > > >> > > > > >>>> have
> > > > > >> > > > > >>>>>>>>>>>>>>>> any
> > > > > >> > > > > >>>>>>>>>>>>>>>> problem to work on that. But I am more
> > > > > >> interested in
> > > > > >> > > > > >>> creative
> > > > > >> > > > > >>>>>>>>>>>>>>>> work
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>> like
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>> implementation of some algorithm or on a
> new
> > > > > >> > > functionality.
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>> I have to mention I have a hard
> > constraint,
> > > > > that
> > > > > >> my
> > > > > >> > > > > >>>> contribution
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>> should
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>> be
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>> at least 100 - 200 lines of code.
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>> So I am writing you to ask if you have
> in
> > > > mind
> > > > > >> some
> > > > > >> > > > > >>>>>>>>>>>>>>>> functionalities
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>> that
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>> I
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>> can help in development. Here some
> > > information
> > > > > >> about
> > > > > >> > my
> > > > > >> > > > > >>>>>>>>>>>>>>>> knowledge in
> > > > > >> > > > > >>>>>>>>>>>>>>>> software engineering and programming
> > > > languages
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>> inetpub/detfolio/.
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>> Thank you for your time and attention.
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>> Regards,
> > > > > >> > > > > >>>>>>>>>>>>>>>> Christos Oikonomou
> > > > > >> > > > > >>>>>>>>>>>>>>>> Assistant researcher at ISTLab
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
> > > > > >> > > > > >>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > > > > >>>>>>>>>>
> > > > > >> > > > > >>>>>>>>
> > > > > >> > > > > >>>>>>
> > > > > >> > > > > >>>>
> > > > > >> > > > > >>>>
> > > > > >> > > > > >>>
> > > > > >> > > > > >>
> > > > > >> > > > >
> > > > > >> > > > >
> > > > > >> > > >
> > > > > >> > >
> > > > > >> >
> > > > > >>
> > > > > >
> > > > > >
> > > > >
> > > >
> > >
> >
>
Re: Contributing to tinkerpop3
Posted by Christos Oikonomou <ch...@gmail.com>.
Hello everyone,
I have finished my work on commands and I have done a pull request
yesterday!
(The checking with travis BI will be done when my request is overviewed for
the pull request or I should do it myself?)
If you have some time review my submission for feedback and corrections.
Thank you for your time anyway
Regards,
Christos
On Tue, May 26, 2015 at 6:14 PM, Stephen Mallette <sp...@gmail.com>
wrote:
> I'd forgotten that we package the javadoc with the zip. I think that makes
> sense. Feel free to share the link to your fork (and more information
> about your design, like how the commands work) when you are ready, however
> the earlier you get feedback the more helpful it might be to you.
>
> On Tue, May 26, 2015 at 10:05 AM, Christos Oikonomou <
> chrikon1994@gmail.com>
> wrote:
>
> > Hello Stephen,
> > I thought that it would be better to avoid reading url if we provide the
> > .html in the release zip.
> > That's why I thought to create two methods to read the javadocs locally
> > (why I need the path) or if that fails to go to url. I f you believe that
> > is not necessary this works fine for me also because it is a lot of work.
> > But this operation will not work off line.
> > For the repo yes I have one folk but I have not finnish all the
> > documentation and junit so I have not push yet, when I do I will send you
> > the link.
> > Regards,
> > Christos
> >
> > On Tue, May 26, 2015 at 2:44 PM, Stephen Mallette <sp...@gmail.com>
> > wrote:
> >
> > > Hi Christos - I assume that you have a fork of TinkerPop3 somewhere?
> > > Perhaps you could point us to your code so that we can see what you've
> > > done? It might be easier to discuss if we could see that. Also, it
> > would
> > > be helpful to know more about your proposed syntax to your commands and
> > > what they will do.
> > >
> > > > Secondly what is the correct path for the javadoc in release and in
> > > development
> > > version?
> > >
> > > We deploy javadocs for every official release and for the current
> > > SNAPSHOT. The Console can find the current version by calling
> > > Gremlin.version() - you should be able to use that to construct the
> right
> > > URL to the javadoc. I think that would work.
> > >
> > >
> > >
> > > On Mon, May 25, 2015 at 9:15 AM, Christos Oikonomou <
> > chrikon1994@gmail.com
> > > >
> > > wrote:
> > >
> > > > Hello everyone
> > > >
> > > > I was working on Java displaying in gremlin console.
> > > > I have came to a point that I need your guidance.
> > > > I have made 3 classes one for importing, for Doc structure in a class
> > and
> > > > third for the structure of the data in a method.
> > > >
> > > > Also I add 2 commands in groovy the ImportDocsCommand and
> DicsCommand.
> > > The
> > > > first impliment the import of the javadocs of a class for the
> > Class.html
> > > > and the second the displaying.
> > > >
> > > > Firstly what are your thoughts for those,
> > > >
> > > > Secondly what is the correct path for the javadoc in release and in
> > > > development version?
> > > >
> > > > Regards
> > > > Christos
> > > >
> > > > On Sat, Apr 25, 2015 at 2:59 PM, Christos Oikonomou <
> > > chrikon1994@gmail.com
> > > > >
> > > > wrote:
> > > >
> > > > > I thought we can create an doc.xml with all the relative
> information
> > > > > gathered for every function.
> > > > >
> > > > > Although I see your point.
> > > > >
> > > > > But I like also the idea of Matt.....
> > > > >
> > > > > As I see this was something that interest you so I will start
> working
> > > on
> > > > > how that should be implemented.
> > > > >
> > > > > Regards,
> > > > > Christos
> > > > >
> > > > > On Sat, Apr 25, 2015 at 1:35 PM, Stephen Mallette <
> > > spmallette@gmail.com>
> > > > > wrote:
> > > > >
> > > > >> Matt, I like idea for a :docimport command. By default we would
> > load
> > > > >> GraphTraversal into it so that
> > > > >>
> > > > >> gremlin> :doc outE
> > > > >>
> > > > >> could resolve to the appropriate javadoc right out the box. It is
> > > > >> generally applicable and as you say might even be of interest to
> the
> > > > >> groovy
> > > > >> project at some point.
> > > > >>
> > > > >> Christos, I think the categories you mention are good, but I would
> > > take
> > > > >> care to consider the source of the documentation. Where would
> those
> > > > >> categories come from for you to display them? I don't think it
> would
> > > be
> > > > >> especially helpful if we had to manage javadoc, the asciidoc and
> > then
> > > > >> another class of documentation for the console. I think that
> > > > re-purposing
> > > > >> the javadoc is the best approach here and if we write some good
> > > javadoc
> > > > we
> > > > >> will roughly cover your categories. You could obviously display
> the
> > > > text
> > > > >> of the javadoc, which would likely cover your first two categories
> > (if
> > > > >> written well). For the links, we could add @see tags as needed to
> > the
> > > > >> javadoc and those would be the links to display in the console.
> > > > >>
> > > > >>
> > > > >>
> > > > >>
> > > > >>
> > > > >> On Fri, Apr 24, 2015 at 7:13 PM, Christos Oikonomou <
> > > > >> chrikon1994@gmail.com>
> > > > >> wrote:
> > > > >>
> > > > >> > I am glad for your reaction.
> > > > >> > I was thinking that we can display the information in 4
> categories
> > > > >> >
> > > > >> > gremlin> :doc foo
> > > > >> > Description of Functionality
> > > > >> > .....
> > > > >> > Some relevant functionalities
> > > > >> > ......
> > > > >> > Link to the user documentation
> > > > >> > ......
> > > > >> > Link to the javadoc
> > > > >> > .........
> > > > >> >
> > > > >> > Do you believe that informations will be clear to all kinds of
> > users
> > > > >> >
> > > > >> > On Sat, Apr 25, 2015 at 12:36 AM, Matt Frantz <
> > > > >> matthew.h.frantz@gmail.com>
> > > > >> > wrote:
> > > > >> >
> > > > >> > > Perhaps there should be a command to import the javadocs for a
> > > > >> particular
> > > > >> > > package or interface, e.g. a DSL interface. The effect would
> be
> > > to
> > > > >> haul
> > > > >> > > the methods into the global doc namespace. By default, we
> would
> > > > apply
> > > > >> > that
> > > > >> > > to GraphTraversal.
> > > > >> > >
> > > > >> > > gremlin> :doc outE
> > > > >> > > TODO: Write a good javadoc for each GraphTraversal method
> > > > >> > > gremlin> :importdoc TinkerFactory.SocialTraversal
> > > > >> > > gremlin> :doc people
> > > > >> > > TODO: Write a good javadoc for each SocialTraversal method
> > > > >> > >
> > > > >> > > It could be applied to any class or interface. Applying it
> to a
> > > > >> package
> > > > >> > > would haul the classes and subpackages into the global doc
> > > > namespace.
> > > > >> > >
> > > > >> > > gremlin> :importdoc
> > > > org.apache.tinkerpop.gremlin.tinkergraph.structure
> > > > >> > > gremlin> :doc TinkerHelper
> > > > >> > > gremlin> :doc TinkerHelper.queryVertexIndex
> > > > >> > >
> > > > >> > > Maybe you could allow fully-qualified resolution without an
> > > import:
> > > > >> > >
> > > > >> > > gremlin> :doc
> > > > >> > >
> > > > >> > >
> > > > >> >
> > > > >>
> > > >
> > >
> >
> org.apache.tinkerpop.gremlin.tinkergraph.structure.TinkerHelper.queryVertexIndex
> > > > >> > >
> > > > >> > > This seems like something that could be contributed upstream
> to
> > > the
> > > > >> > Groovy
> > > > >> > > REPL.
> > > > >> > >
> > > > >> > > On Fri, Apr 24, 2015 at 12:10 PM, Stephen Mallette <
> > > > >> spmallette@gmail.com
> > > > >> > >
> > > > >> > > wrote:
> > > > >> > >
> > > > >> > > > Yeah - it would be straightforward to bring in javadoc for
> the
> > > > most
> > > > >> > part:
> > > > >> > > >
> > > > >> > > > gremlin> :doc EdgeVertexStep
> > > > >> > > >
> > > > >> > > > you can get the class from that and full package name with
> > > > >> reflection
> > > > >> > > then
> > > > >> > > > translate it to javadoc to extract some text to display in
> the
> > > > >> console.
> > > > >> > > I
> > > > >> > > > guess that's nice, but no one knows VertexStep. They know
> > this
> > > > step
> > > > >> > > > though:
> > > > >> > > >
> > > > >> > > > gremlin> :doc outE
> > > > >> > > >
> > > > >> > > > So - I guess the question is how one would go from just a
> pure
> > > > >> javadoc
> > > > >> > > > lookup command (cool but a bit less useful to a first time
> > user
> > > > who
> > > > >> > > doesn't
> > > > >> > > > know the classes - not that EdgeVertexStep would yield
> > anything
> > > > >> about
> > > > >> > > outE
> > > > >> > > > for that matter as it sits) to something that gives the user
> > > > >> content on
> > > > >> > > > steps from GraphTraversal which is the core of the DSL. And
> > > then
> > > > -
> > > > >> how
> > > > >> > > > would it extend to other DSLs so that it was generally
> > > applicable
> > > > to
> > > > >> > > those
> > > > >> > > > extending the language.
> > > > >> > > >
> > > > >> > > >
> > > > >> > > >
> > > > >> > > > On Fri, Apr 24, 2015 at 3:02 PM, Marko Rodriguez <
> > > > >> okrammarko@gmail.com
> > > > >> > >
> > > > >> > > > wrote:
> > > > >> > > >
> > > > >> > > > > That would be really classy. It would be cool if that
> could
> > be
> > > > >> read
> > > > >> > > from
> > > > >> > > > > the JavaDoc somehow………… then we kill two birds with one
> > stone.
> > > > >> > > > >
> > > > >> > > > > Marko.
> > > > >> > > > >
> > > > >> > > > > http://markorodriguez.com
> > > > >> > > > >
> > > > >> > > > > On Apr 24, 2015, at 12:08 PM, Stephen Mallette <
> > > > >> spmallette@gmail.com
> > > > >> > >
> > > > >> > > > > wrote:
> > > > >> > > > >
> > > > >> > > > > >> A gremlin-command that display in gremlin-console user
> > > > >> > documentation
> > > > >> > > > or
> > > > >> > > > > > javadocs of a gremlin functionality could be something
> > that
> > > > >> helps
> > > > >> > > user?
> > > > >> > > > > >
> > > > >> > > > > > That's an interesting idea. I assume you are suggesting
> > > > >> something
> > > > >> > > > like:
> > > > >> > > > > >
> > > > >> > > > > > gremlin> :doc choose
> > > > >> > > > > > ==>The choose()-step (branch) routes the current
> traverser
> > > to
> > > > a
> > > > >> > > > > particular
> > > > >> > > > > > traversal branch option. With choose(), it is possible
> to
> > > > >> > > > implement......
> > > > >> > > > > >
> > > > >> > > > > > Is that what you mean?
> > > > >> > > > > >
> > > > >> > > > > >
> > > > >> > > > > >
> > > > >> > > > > >
> > > > >> > > > > > On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <
> > > > >> > > > > chrikon1994@gmail.com>
> > > > >> > > > > > wrote:
> > > > >> > > > > >
> > > > >> > > > > >> Hello and sorry for the delay. Thanks for the answers.
> > > > >> > > > > >> I have done a general overview of all the code base.
> But
> > > more
> > > > >> > > > > familiarized
> > > > >> > > > > >> I am in gremlin-core and gremlin-console.
> > > > >> > > > > >> I prefer the assignment of issues because I wants to
> help
> > > > also
> > > > >> to
> > > > >> > > the
> > > > >> > > > > >> faster achievement of the project planning in general.
> > > > >> > > > > >> Also I have an idea in documentation. A gremlin-command
> > > that
> > > > >> > display
> > > > >> > > > in
> > > > >> > > > > >> gremlin-console user documentation or javadocs of a
> > gremlin
> > > > >> > > > > functionality
> > > > >> > > > > >> could be something that helps user?
> > > > >> > > > > >>
> > > > >> > > > > >> Regards,
> > > > >> > > > > >> Christos
> > > > >> > > > > >>
> > > > >> > > > > >> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <
> > > > >> > > > > m.ben.franklin@gmail.com>
> > > > >> > > > > >> wrote:
> > > > >> > > > > >>
> > > > >> > > > > >>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <
> > > > >> > > > okrammarko@gmail.com>
> > > > >> > > > > >>> wrote:
> > > > >> > > > > >>>
> > > > >> > > > > >>>> Hi Christos,
> > > > >> > > > > >>>>
> > > > >> > > > > >>>> Given that you have familiarized yourself with the
> > > > codebase,
> > > > >> > which
> > > > >> > > > > area
> > > > >> > > > > >>> of
> > > > >> > > > > >>>> the codebase do you feel:
> > > > >> > > > > >>>>
> > > > >> > > > > >>>> 1. you understand the best, and
> > > > >> > > > > >>>> 2. are interested in working on.
> > > > >> > > > > >>>>
> > > > >> > > > > >>>> Given that information, I will be able to figure out
> > > > >> something
> > > > >> > > > > >> particular
> > > > >> > > > > >>>> for you to do.
> > > > >> > > > > >>>>
> > > > >> > > > > >>>
> > > > >> > > > > >>> You should also feel free to pick an issue off of JIRA
> > > > >> yourself,
> > > > >> > or
> > > > >> > > > > even
> > > > >> > > > > >>> create an issue and submit a patch for it.
> > > > >> > > > > >>>
> > > > >> > > > > >>>
> > > > >> > > > > >>>>
> > > > >> > > > > >>>> Thanks,
> > > > >> > > > > >>>> Marko.
> > > > >> > > > > >>>>
> > > > >> > > > > >>>> http://markorodriguez.com
> > > > >> > > > > >>>>
> > > > >> > > > > >>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
> > > > >> > > > > >> chrikon1994@gmail.com>
> > > > >> > > > > >>>> wrote:
> > > > >> > > > > >>>>
> > > > >> > > > > >>>>> Hello everyone,
> > > > >> > > > > >>>>>
> > > > >> > > > > >>>>> I have read your advices how to start and how to be
> > > > >> > familiarized
> > > > >> > > > with
> > > > >> > > > > >>> the
> > > > >> > > > > >>>>> codebase. After some time I spent exploring the
> code,
> > I
> > > > >> > believe I
> > > > >> > > > am
> > > > >> > > > > >>>> ready
> > > > >> > > > > >>>>> to start specific changes in the code.
> > > > >> > > > > >>>>>
> > > > >> > > > > >>>>> So am sending this message to ask you, if some of
> you
> > > have
> > > > >> > ideas
> > > > >> > > > > >> about
> > > > >> > > > > >>>>> features or improvement and you want one more for
> > help.
> > > > >> > > > > >>>>>
> > > > >> > > > > >>>>> Also if you have some issues you want some help
> please
> > > let
> > > > >> me
> > > > >> > > know
> > > > >> > > > > >>> (jira
> > > > >> > > > > >>>>> account chrikon).
> > > > >> > > > > >>>>>
> > > > >> > > > > >>>>> Thanks in advance,
> > > > >> > > > > >>>>>
> > > > >> > > > > >>>>> Regards
> > > > >> > > > > >>>>> Christos
> > > > >> > > > > >>>>>
> > > > >> > > > > >>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou
> <
> > > > >> > > > > >>>> chrikon1994@gmail.com>
> > > > >> > > > > >>>>> wrote:
> > > > >> > > > > >>>>>
> > > > >> > > > > >>>>>> Sorry Hadrian thank you for your correction, this
> > will
> > > > not
> > > > >> > > happen
> > > > >> > > > > >>> again!
> > > > >> > > > > >>>>>>
> > > > >> > > > > >>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <
> > > > >> > > > > >> hzbarcea@gmail.com>
> > > > >> > > > > >>>>>> wrote:
> > > > >> > > > > >>>>>>
> > > > >> > > > > >>>>>>> Hi Christos,
> > > > >> > > > > >>>>>>>
> > > > >> > > > > >>>>>>> First off, I am not a Mister :), just Hadrian.
> > > > >> > > > > >>>>>>>
> > > > >> > > > > >>>>>>> Yes, the idea is to collaborate, that's what open
> > > source
> > > > >> is
> > > > >> > > > about.
> > > > >> > > > > >>>>>>>
> > > > >> > > > > >>>>>>> Good luck,
> > > > >> > > > > >>>>>>> Hadrian
> > > > >> > > > > >>>>>>>
> > > > >> > > > > >>>>>>>
> > > > >> > > > > >>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
> > > > >> > > > > >>>>>>>
> > > > >> > > > > >>>>>>>> Firstly thank you all for your suggestions, all
> of
> > > them
> > > > >> are
> > > > >> > > very
> > > > >> > > > > >>>> helpful.
> > > > >> > > > > >>>>>>>>
> > > > >> > > > > >>>>>>>> In this moment I follow the very good advice and
> I
> > am
> > > > >> > reading
> > > > >> > > > > >>>>>>>> documentation, because next Wednesday I have to
> > make
> > > a
> > > > >> > > > > >> presentation
> > > > >> > > > > >>>> for
> > > > >> > > > > >>>>>>>> tinkerpop in front of my class!
> > > > >> > > > > >>>>>>>>
> > > > >> > > > > >>>>>>>> Marko I have to write code for my assignment, but
> > in
> > > my
> > > > >> free
> > > > >> > > > time
> > > > >> > > > > >> it
> > > > >> > > > > >>>> is
> > > > >> > > > > >>>>>>>> an
> > > > >> > > > > >>>>>>>> interesting work.
> > > > >> > > > > >>>>>>>>
> > > > >> > > > > >>>>>>>> Although Javadoc it is applicable to my
> > assignment, I
> > > > >> > think. I
> > > > >> > > > > >> will
> > > > >> > > > > >>>> ask
> > > > >> > > > > >>>>>>>> and
> > > > >> > > > > >>>>>>>> I will have news.
> > > > >> > > > > >>>>>>>>
> > > > >> > > > > >>>>>>>> If Mr. Hadrian Zbarcea are working on it, I would
> > > like
> > > > >> not
> > > > >> > to
> > > > >> > > > > >>>> interfere
> > > > >> > > > > >>>>>>>> in
> > > > >> > > > > >>>>>>>> your job, or we can cooperate.
> > > > >> > > > > >>>>>>>> Before that discussion I have to contact to my
> > > academic
> > > > >> > > > supervisor
> > > > >> > > > > >>> in
> > > > >> > > > > >>>>>>>> order
> > > > >> > > > > >>>>>>>> to be 100% sure that this is ok.
> > > > >> > > > > >>>>>>>>
> > > > >> > > > > >>>>>>>> P.S. I hope my English is at least
> understandable,
> > if
> > > > >> not so
> > > > >> > > > > >> please
> > > > >> > > > > >>>> ask
> > > > >> > > > > >>>>>>>> me
> > > > >> > > > > >>>>>>>> again.
> > > > >> > > > > >>>>>>>>
> > > > >> > > > > >>>>>>>> Thank you all.
> > > > >> > > > > >>>>>>>> Christos
> > > > >> > > > > >>>>>>>>
> > > > >> > > > > >>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea
> <
> > > > >> > > > > >>> hzbarcea@gmail.com>
> > > > >> > > > > >>>>>>>> wrote:
> > > > >> > > > > >>>>>>>>
> > > > >> > > > > >>>>>>>> That's something I am interested in too.
> > > > >> > > > > >>>>>>>>> Hadrian
> > > > >> > > > > >>>>>>>>>
> > > > >> > > > > >>>>>>>>>
> > > > >> > > > > >>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
> > > > >> > > > > >>>>>>>>>
> > > > >> > > > > >>>>>>>>> Hi Christos,
> > > > >> > > > > >>>>>>>>>>
> > > > >> > > > > >>>>>>>>>> Another thing that we need is more JavaDoc! Its
> > not
> > > > >> sexy,
> > > > >> > > but
> > > > >> > > > > >> boy
> > > > >> > > > > >>>> would
> > > > >> > > > > >>>>>>>>>> be it be great to have someone go through and
> > > > >> JavaDoc-up
> > > > >> > > > > >>>> GraphTraversal
> > > > >> > > > > >>>>>>>>>> (all those methods…).
> > > > >> > > > > >>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>
> > > > >> > https://github.com/apache/incubator-tinkerpop/blob/
> > > > >> > > > > >>>>>>>>>>
> > > > master/gremlin-core/src/main/java/org/apache/tinkerpop/
> > > > >> > > > > >>>>>>>>>>
> > > > gremlin/process/traversal/dsl/graph/GraphTraversal.java
> > > > >> > > > > >>>>>>>>>>
> > > > >> > > > > >>>>>>>>>> …the docs provide a description of each step.
> > > > >> > > > > >>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>
> > > > >> http://tinkerpop.incubator.apache.org/docs/3.0.0-
> > > > >> > > > > >>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct
> > > clicking
> > > > to
> > > > >> > any
> > > > >> > > > > >>>> particular
> > > > >> > > > > >>>>>>>>>> step)
> > > > >> > > > > >>>>>>>>>>
> > > > >> > > > > >>>>>>>>>> I would say that would be more helpful now
> than a
> > > > >> "Through
> > > > >> > > the
> > > > >> > > > > >>>>>>>>>> TinkerPop"-tutorial.
> > > > >> > > > > >>>>>>>>>>
> > > > >> > > > > >>>>>>>>>> Finally, what else would be helpful --- more
> test
> > > > >> cases.
> > > > >> > If
> > > > >> > > > you
> > > > >> > > > > >>> are
> > > > >> > > > > >>>>>>>>>> interested in testing, I can get your set up in
> > > with
> > > > "a
> > > > >> > > > pattern"
> > > > >> > > > > >>> so
> > > > >> > > > > >>>>>>>>>> you pop
> > > > >> > > > > >>>>>>>>>> out more process/ tests. For example:
> > > > >> > > > > >>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>
> > > > >> > https://github.com/apache/incubator-tinkerpop/blob/
> > > > >> > > > > >>>>>>>>>>
> > > > master/gremlin-test/src/main/java/org/apache/tinkerpop/
> > > > >> > > > > >>>>>>>>>>
> gremlin/process/traversal/step/map/CountTest.java
> > > > >> > > > > >>>>>>>>>>
> > > > >> > > > > >>>>>>>>>> Thanks,
> > > > >> > > > > >>>>>>>>>> Marko.
> > > > >> > > > > >>>>>>>>>>
> > > > >> > > > > >>>>>>>>>> http://markorodriguez.com
> > > > >> > > > > >>>>>>>>>>
> > > > >> > > > > >>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <
> > > > >> > > > > >>> okrammarko@gmail.com>
> > > > >> > > > > >>>>>>>>>> wrote:
> > > > >> > > > > >>>>>>>>>>
> > > > >> > > > > >>>>>>>>>> Hi Christos,
> > > > >> > > > > >>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>> Are you interested in writing code or perhaps,
> > > > >> writing a
> > > > >> > > > > >>> tutorial?
> > > > >> > > > > >>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>> It would be nice to have an in-depth tutorial
> on
> > > > >> > > TinkerPop3.
> > > > >> > > > > >> For
> > > > >> > > > > >>>>>>>>>>> instance, find a reasonably sized dataset (<1
> > > > million
> > > > >> > > edges),
> > > > >> > > > > >>> parse
> > > > >> > > > > >>>>>>>>>>> it into
> > > > >> > > > > >>>>>>>>>>> a graph, do some analysis on it, expose it via
> > > > Gremlin
> > > > >> > > > Server,
> > > > >> > > > > >>> OLTP
> > > > >> > > > > >>>>>>>>>>> and
> > > > >> > > > > >>>>>>>>>>> OLAP queries hitting it, etc. Write up the
> path
> > > you
> > > > >> took
> > > > >> > > into
> > > > >> > > > > >> an
> > > > >> > > > > >>>>>>>>>>> AsciiDoc
> > > > >> > > > > >>>>>>>>>>> and we could put it on the Apache TinkerPop
> site
> > > as
> > > > a
> > > > >> > > > "Through
> > > > >> > > > > >>> the
> > > > >> > > > > >>>>>>>>>>> TinkerPop" tutorial. Be great if you could
> touch
> > > on
> > > > >> every
> > > > >> > > > > >> aspect
> > > > >> > > > > >>> of
> > > > >> > > > > >>>>>>>>>>> the
> > > > >> > > > > >>>>>>>>>>> TinkerPop framework in the tutorial.
> > > > >> > > > > >>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>> I would appreciate a contribution like that.
> > > > >> > > > > >>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>> Thanks,
> > > > >> > > > > >>>>>>>>>>> Marko.
> > > > >> > > > > >>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>> http://markorodriguez.com
> > > > >> > > > > >>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
> > > > >> > > > > >>>> m.ben.franklin@gmail.com>
> > > > >> > > > > >>>>>>>>>>> wrote:
> > > > >> > > > > >>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen
> > Mallette <
> > > > >> > > > > >>>>>>>>>>> spmallette@gmail.com>
> > > > >> > > > > >>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>> wrote:
> > > > >> > > > > >>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>> My suggestion would be for you to spend some
> > time
> > > > >> > learning
> > > > >> > > > > >>> about
> > > > >> > > > > >>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>> TinkerPop
> > > > >> > > > > >>>>>>>>>>>>> (reading the documentation, examining the
> code
> > > > base,
> > > > >> > > > perusing
> > > > >> > > > > >>> the
> > > > >> > > > > >>>>>>>>>>>>> Jira
> > > > >> > > > > >>>>>>>>>>>>> issue tracker, etc.) to determine if any
> > > > particular
> > > > >> > part
> > > > >> > > of
> > > > >> > > > > >> the
> > > > >> > > > > >>>>>>>>>>>>> stack
> > > > >> > > > > >>>>>>>>>>>>> interests you.
> > > > >> > > > > >>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>> IMO, there is no better way to get involved
> > than
> > > to
> > > > >> pick
> > > > >> > > > > >>> something
> > > > >> > > > > >>>>>>>>>>>> that
> > > > >> > > > > >>>>>>>>>>>> needs to be worked on and provide a patch for
> > it.
> > > > I
> > > > >> > would
> > > > >> > > > > >> look
> > > > >> > > > > >>> at
> > > > >> > > > > >>>>>>>>>>>> JIRA
> > > > >> > > > > >>>>>>>>>>>> and
> > > > >> > > > > >>>>>>>>>>>> find an issue that interests you.
> > > > >> > > > > >>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>> In doing that, you might develop your own
> ideas
> > > as
> > > > to
> > > > >> > > > > >>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>> where/what you think you are best suited to
> > > > >> contribute.
> > > > >> > > At
> > > > >> > > > > >>> that
> > > > >> > > > > >>>>>>>>>>>>> point
> > > > >> > > > > >>>>>>>>>>>>> you
> > > > >> > > > > >>>>>>>>>>>>> could post those ideas here in the mailing
> > list
> > > > for
> > > > >> > > > feedback.
> > > > >> > > > > >>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos
> > > > Oikonomou
> > > > >> <
> > > > >> > > > > >>>>>>>>>>>>> chrikon1994@gmail.com
> > > > >> > > > > >>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>> wrote:
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>> Hi Stephen
> > > > >> > > > > >>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>> When I start I was not familiar with the
> > > project
> > > > >> nor
> > > > >> > the
> > > > >> > > > > >>>>>>>>>>>>>> architecture/codebase.
> > > > >> > > > > >>>>>>>>>>>>>> But I am reading about tinkerpop and
> > searching
> > > in
> > > > >> the
> > > > >> > > code
> > > > >> > > > > >> and
> > > > >> > > > > >>>>>>>>>>>>>> I am thinking to make some simple examples
> in
> > > > >> order to
> > > > >> > > be
> > > > >> > > > > >> more
> > > > >> > > > > >>>>>>>>>>>>>> familiar
> > > > >> > > > > >>>>>>>>>>>>>> with the functionality.
> > > > >> > > > > >>>>>>>>>>>>>> So I am not now very familiar but I try to
> be
> > > in
> > > > >> the
> > > > >> > > near
> > > > >> > > > > >>>> future.
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>> Christos
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen
> > > > Mallette <
> > > > >> > > > > >>>>>>>>>>>>>> spmallette@gmail.com>
> > > > >> > > > > >>>>>>>>>>>>>> wrote:
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>> Hi Christos, we appreciate your offer to
> > > > >> contribute.
> > > > >> > > > Could
> > > > >> > > > > >>> you
> > > > >> > > > > >>>>>>>>>>>>>> tell
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>> us
> > > > >> > > > > >>>>>>>>>>>>>>> what kind of experience you have with
> > > TinkerPop
> > > > so
> > > > >> > far?
> > > > >> > > > > >> Are
> > > > >> > > > > >>>> you
> > > > >> > > > > >>>>>>>>>>>>>>> at
> > > > >> > > > > >>>>>>>>>>>>>>> all
> > > > >> > > > > >>>>>>>>>>>>>>> familiar with the architecture/codebase?
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>> Stephen
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos
> > > > >> Oikonomou
> > > > >> > <
> > > > >> > > > > >>>>>>>>>>>>>>> chrikon1994@gmail.com>
> > > > >> > > > > >>>>>>>>>>>>>>> wrote:
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>> Dear Tinkerpop Development Team
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>> My name is Christos Economou.
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>> I would like to contribute in the
> > tinkerpop3.
> > > > >> > > > > >>>>>>>>>>>>>>>> This contribution will be a part of an
> > > > >> assignment in
> > > > >> > > one
> > > > >> > > > > >> of
> > > > >> > > > > >>> my
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>> classes.
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>> I am in my third year of study at Athens
> > > > >> University of
> > > > >> > > > > >>> Economics
> > > > >> > > > > >>>>>>>>>>>>>>>> and
> > > > >> > > > > >>>>>>>>>>>>>>>> Business (Greece | Hellas).In this
> > semester I
> > > > >> attend
> > > > >> > > in
> > > > >> > > > > >>>> lectures
> > > > >> > > > > >>>>>>>>>>>>>>>> that
> > > > >> > > > > >>>>>>>>>>>>>>>> called "Advanced Topics in Software
> > > > Engineering"
> > > > >> by
> > > > >> > > > > >>> professor
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>> Diomidis
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>> Spinellis.
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>> As assignment I have to contribute in an
> > open
> > > > >> source
> > > > >> > > > > >>> project.
> > > > >> > > > > >>>> I
> > > > >> > > > > >>>>>>>>>>>>>>>> would
> > > > >> > > > > >>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3. More
> > > > >> > specifically
> > > > >> > > I
> > > > >> > > > > >>>>>>>>>>>>>>>> understand
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>> that
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>> in
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>> big projects, like this, always exists
> work
> > on
> > > > >> > > > integration
> > > > >> > > > > >>> and
> > > > >> > > > > >>>>>>>>>>>>>>>> collaboration between components and
> > > > subsystems.
> > > > >> So
> > > > >> > I
> > > > >> > > do
> > > > >> > > > > >> not
> > > > >> > > > > >>>> have
> > > > >> > > > > >>>>>>>>>>>>>>>> any
> > > > >> > > > > >>>>>>>>>>>>>>>> problem to work on that. But I am more
> > > > >> interested in
> > > > >> > > > > >>> creative
> > > > >> > > > > >>>>>>>>>>>>>>>> work
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>> like
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>> implementation of some algorithm or on a new
> > > > >> > > functionality.
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>> I have to mention I have a hard
> constraint,
> > > > that
> > > > >> my
> > > > >> > > > > >>>> contribution
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>> should
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>> be
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>> at least 100 - 200 lines of code.
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>> So I am writing you to ask if you have in
> > > mind
> > > > >> some
> > > > >> > > > > >>>>>>>>>>>>>>>> functionalities
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>> that
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>> I
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>> can help in development. Here some
> > information
> > > > >> about
> > > > >> > my
> > > > >> > > > > >>>>>>>>>>>>>>>> knowledge in
> > > > >> > > > > >>>>>>>>>>>>>>>> software engineering and programming
> > > languages
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>> inetpub/detfolio/.
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>> Thank you for your time and attention.
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>> Regards,
> > > > >> > > > > >>>>>>>>>>>>>>>> Christos Oikonomou
> > > > >> > > > > >>>>>>>>>>>>>>>> Assistant researcher at ISTLab
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
> > > > >> > > > > >>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>
> > > > >> > > > > >>>>>>>>>>
> > > > >> > > > > >>>>>>>>
> > > > >> > > > > >>>>>>
> > > > >> > > > > >>>>
> > > > >> > > > > >>>>
> > > > >> > > > > >>>
> > > > >> > > > > >>
> > > > >> > > > >
> > > > >> > > > >
> > > > >> > > >
> > > > >> > >
> > > > >> >
> > > > >>
> > > > >
> > > > >
> > > >
> > >
> >
>
Re: Contributing to tinkerpop3
Posted by Stephen Mallette <sp...@gmail.com>.
I'd forgotten that we package the javadoc with the zip. I think that makes
sense. Feel free to share the link to your fork (and more information
about your design, like how the commands work) when you are ready, however
the earlier you get feedback the more helpful it might be to you.
On Tue, May 26, 2015 at 10:05 AM, Christos Oikonomou <ch...@gmail.com>
wrote:
> Hello Stephen,
> I thought that it would be better to avoid reading url if we provide the
> .html in the release zip.
> That's why I thought to create two methods to read the javadocs locally
> (why I need the path) or if that fails to go to url. I f you believe that
> is not necessary this works fine for me also because it is a lot of work.
> But this operation will not work off line.
> For the repo yes I have one folk but I have not finnish all the
> documentation and junit so I have not push yet, when I do I will send you
> the link.
> Regards,
> Christos
>
> On Tue, May 26, 2015 at 2:44 PM, Stephen Mallette <sp...@gmail.com>
> wrote:
>
> > Hi Christos - I assume that you have a fork of TinkerPop3 somewhere?
> > Perhaps you could point us to your code so that we can see what you've
> > done? It might be easier to discuss if we could see that. Also, it
> would
> > be helpful to know more about your proposed syntax to your commands and
> > what they will do.
> >
> > > Secondly what is the correct path for the javadoc in release and in
> > development
> > version?
> >
> > We deploy javadocs for every official release and for the current
> > SNAPSHOT. The Console can find the current version by calling
> > Gremlin.version() - you should be able to use that to construct the right
> > URL to the javadoc. I think that would work.
> >
> >
> >
> > On Mon, May 25, 2015 at 9:15 AM, Christos Oikonomou <
> chrikon1994@gmail.com
> > >
> > wrote:
> >
> > > Hello everyone
> > >
> > > I was working on Java displaying in gremlin console.
> > > I have came to a point that I need your guidance.
> > > I have made 3 classes one for importing, for Doc structure in a class
> and
> > > third for the structure of the data in a method.
> > >
> > > Also I add 2 commands in groovy the ImportDocsCommand and DicsCommand.
> > The
> > > first impliment the import of the javadocs of a class for the
> Class.html
> > > and the second the displaying.
> > >
> > > Firstly what are your thoughts for those,
> > >
> > > Secondly what is the correct path for the javadoc in release and in
> > > development version?
> > >
> > > Regards
> > > Christos
> > >
> > > On Sat, Apr 25, 2015 at 2:59 PM, Christos Oikonomou <
> > chrikon1994@gmail.com
> > > >
> > > wrote:
> > >
> > > > I thought we can create an doc.xml with all the relative information
> > > > gathered for every function.
> > > >
> > > > Although I see your point.
> > > >
> > > > But I like also the idea of Matt.....
> > > >
> > > > As I see this was something that interest you so I will start working
> > on
> > > > how that should be implemented.
> > > >
> > > > Regards,
> > > > Christos
> > > >
> > > > On Sat, Apr 25, 2015 at 1:35 PM, Stephen Mallette <
> > spmallette@gmail.com>
> > > > wrote:
> > > >
> > > >> Matt, I like idea for a :docimport command. By default we would
> load
> > > >> GraphTraversal into it so that
> > > >>
> > > >> gremlin> :doc outE
> > > >>
> > > >> could resolve to the appropriate javadoc right out the box. It is
> > > >> generally applicable and as you say might even be of interest to the
> > > >> groovy
> > > >> project at some point.
> > > >>
> > > >> Christos, I think the categories you mention are good, but I would
> > take
> > > >> care to consider the source of the documentation. Where would those
> > > >> categories come from for you to display them? I don't think it would
> > be
> > > >> especially helpful if we had to manage javadoc, the asciidoc and
> then
> > > >> another class of documentation for the console. I think that
> > > re-purposing
> > > >> the javadoc is the best approach here and if we write some good
> > javadoc
> > > we
> > > >> will roughly cover your categories. You could obviously display the
> > > text
> > > >> of the javadoc, which would likely cover your first two categories
> (if
> > > >> written well). For the links, we could add @see tags as needed to
> the
> > > >> javadoc and those would be the links to display in the console.
> > > >>
> > > >>
> > > >>
> > > >>
> > > >>
> > > >> On Fri, Apr 24, 2015 at 7:13 PM, Christos Oikonomou <
> > > >> chrikon1994@gmail.com>
> > > >> wrote:
> > > >>
> > > >> > I am glad for your reaction.
> > > >> > I was thinking that we can display the information in 4 categories
> > > >> >
> > > >> > gremlin> :doc foo
> > > >> > Description of Functionality
> > > >> > .....
> > > >> > Some relevant functionalities
> > > >> > ......
> > > >> > Link to the user documentation
> > > >> > ......
> > > >> > Link to the javadoc
> > > >> > .........
> > > >> >
> > > >> > Do you believe that informations will be clear to all kinds of
> users
> > > >> >
> > > >> > On Sat, Apr 25, 2015 at 12:36 AM, Matt Frantz <
> > > >> matthew.h.frantz@gmail.com>
> > > >> > wrote:
> > > >> >
> > > >> > > Perhaps there should be a command to import the javadocs for a
> > > >> particular
> > > >> > > package or interface, e.g. a DSL interface. The effect would be
> > to
> > > >> haul
> > > >> > > the methods into the global doc namespace. By default, we would
> > > apply
> > > >> > that
> > > >> > > to GraphTraversal.
> > > >> > >
> > > >> > > gremlin> :doc outE
> > > >> > > TODO: Write a good javadoc for each GraphTraversal method
> > > >> > > gremlin> :importdoc TinkerFactory.SocialTraversal
> > > >> > > gremlin> :doc people
> > > >> > > TODO: Write a good javadoc for each SocialTraversal method
> > > >> > >
> > > >> > > It could be applied to any class or interface. Applying it to a
> > > >> package
> > > >> > > would haul the classes and subpackages into the global doc
> > > namespace.
> > > >> > >
> > > >> > > gremlin> :importdoc
> > > org.apache.tinkerpop.gremlin.tinkergraph.structure
> > > >> > > gremlin> :doc TinkerHelper
> > > >> > > gremlin> :doc TinkerHelper.queryVertexIndex
> > > >> > >
> > > >> > > Maybe you could allow fully-qualified resolution without an
> > import:
> > > >> > >
> > > >> > > gremlin> :doc
> > > >> > >
> > > >> > >
> > > >> >
> > > >>
> > >
> >
> org.apache.tinkerpop.gremlin.tinkergraph.structure.TinkerHelper.queryVertexIndex
> > > >> > >
> > > >> > > This seems like something that could be contributed upstream to
> > the
> > > >> > Groovy
> > > >> > > REPL.
> > > >> > >
> > > >> > > On Fri, Apr 24, 2015 at 12:10 PM, Stephen Mallette <
> > > >> spmallette@gmail.com
> > > >> > >
> > > >> > > wrote:
> > > >> > >
> > > >> > > > Yeah - it would be straightforward to bring in javadoc for the
> > > most
> > > >> > part:
> > > >> > > >
> > > >> > > > gremlin> :doc EdgeVertexStep
> > > >> > > >
> > > >> > > > you can get the class from that and full package name with
> > > >> reflection
> > > >> > > then
> > > >> > > > translate it to javadoc to extract some text to display in the
> > > >> console.
> > > >> > > I
> > > >> > > > guess that's nice, but no one knows VertexStep. They know
> this
> > > step
> > > >> > > > though:
> > > >> > > >
> > > >> > > > gremlin> :doc outE
> > > >> > > >
> > > >> > > > So - I guess the question is how one would go from just a pure
> > > >> javadoc
> > > >> > > > lookup command (cool but a bit less useful to a first time
> user
> > > who
> > > >> > > doesn't
> > > >> > > > know the classes - not that EdgeVertexStep would yield
> anything
> > > >> about
> > > >> > > outE
> > > >> > > > for that matter as it sits) to something that gives the user
> > > >> content on
> > > >> > > > steps from GraphTraversal which is the core of the DSL. And
> > then
> > > -
> > > >> how
> > > >> > > > would it extend to other DSLs so that it was generally
> > applicable
> > > to
> > > >> > > those
> > > >> > > > extending the language.
> > > >> > > >
> > > >> > > >
> > > >> > > >
> > > >> > > > On Fri, Apr 24, 2015 at 3:02 PM, Marko Rodriguez <
> > > >> okrammarko@gmail.com
> > > >> > >
> > > >> > > > wrote:
> > > >> > > >
> > > >> > > > > That would be really classy. It would be cool if that could
> be
> > > >> read
> > > >> > > from
> > > >> > > > > the JavaDoc somehow………… then we kill two birds with one
> stone.
> > > >> > > > >
> > > >> > > > > Marko.
> > > >> > > > >
> > > >> > > > > http://markorodriguez.com
> > > >> > > > >
> > > >> > > > > On Apr 24, 2015, at 12:08 PM, Stephen Mallette <
> > > >> spmallette@gmail.com
> > > >> > >
> > > >> > > > > wrote:
> > > >> > > > >
> > > >> > > > > >> A gremlin-command that display in gremlin-console user
> > > >> > documentation
> > > >> > > > or
> > > >> > > > > > javadocs of a gremlin functionality could be something
> that
> > > >> helps
> > > >> > > user?
> > > >> > > > > >
> > > >> > > > > > That's an interesting idea. I assume you are suggesting
> > > >> something
> > > >> > > > like:
> > > >> > > > > >
> > > >> > > > > > gremlin> :doc choose
> > > >> > > > > > ==>The choose()-step (branch) routes the current traverser
> > to
> > > a
> > > >> > > > > particular
> > > >> > > > > > traversal branch option. With choose(), it is possible to
> > > >> > > > implement......
> > > >> > > > > >
> > > >> > > > > > Is that what you mean?
> > > >> > > > > >
> > > >> > > > > >
> > > >> > > > > >
> > > >> > > > > >
> > > >> > > > > > On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <
> > > >> > > > > chrikon1994@gmail.com>
> > > >> > > > > > wrote:
> > > >> > > > > >
> > > >> > > > > >> Hello and sorry for the delay. Thanks for the answers.
> > > >> > > > > >> I have done a general overview of all the code base. But
> > more
> > > >> > > > > familiarized
> > > >> > > > > >> I am in gremlin-core and gremlin-console.
> > > >> > > > > >> I prefer the assignment of issues because I wants to help
> > > also
> > > >> to
> > > >> > > the
> > > >> > > > > >> faster achievement of the project planning in general.
> > > >> > > > > >> Also I have an idea in documentation. A gremlin-command
> > that
> > > >> > display
> > > >> > > > in
> > > >> > > > > >> gremlin-console user documentation or javadocs of a
> gremlin
> > > >> > > > > functionality
> > > >> > > > > >> could be something that helps user?
> > > >> > > > > >>
> > > >> > > > > >> Regards,
> > > >> > > > > >> Christos
> > > >> > > > > >>
> > > >> > > > > >> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <
> > > >> > > > > m.ben.franklin@gmail.com>
> > > >> > > > > >> wrote:
> > > >> > > > > >>
> > > >> > > > > >>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <
> > > >> > > > okrammarko@gmail.com>
> > > >> > > > > >>> wrote:
> > > >> > > > > >>>
> > > >> > > > > >>>> Hi Christos,
> > > >> > > > > >>>>
> > > >> > > > > >>>> Given that you have familiarized yourself with the
> > > codebase,
> > > >> > which
> > > >> > > > > area
> > > >> > > > > >>> of
> > > >> > > > > >>>> the codebase do you feel:
> > > >> > > > > >>>>
> > > >> > > > > >>>> 1. you understand the best, and
> > > >> > > > > >>>> 2. are interested in working on.
> > > >> > > > > >>>>
> > > >> > > > > >>>> Given that information, I will be able to figure out
> > > >> something
> > > >> > > > > >> particular
> > > >> > > > > >>>> for you to do.
> > > >> > > > > >>>>
> > > >> > > > > >>>
> > > >> > > > > >>> You should also feel free to pick an issue off of JIRA
> > > >> yourself,
> > > >> > or
> > > >> > > > > even
> > > >> > > > > >>> create an issue and submit a patch for it.
> > > >> > > > > >>>
> > > >> > > > > >>>
> > > >> > > > > >>>>
> > > >> > > > > >>>> Thanks,
> > > >> > > > > >>>> Marko.
> > > >> > > > > >>>>
> > > >> > > > > >>>> http://markorodriguez.com
> > > >> > > > > >>>>
> > > >> > > > > >>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
> > > >> > > > > >> chrikon1994@gmail.com>
> > > >> > > > > >>>> wrote:
> > > >> > > > > >>>>
> > > >> > > > > >>>>> Hello everyone,
> > > >> > > > > >>>>>
> > > >> > > > > >>>>> I have read your advices how to start and how to be
> > > >> > familiarized
> > > >> > > > with
> > > >> > > > > >>> the
> > > >> > > > > >>>>> codebase. After some time I spent exploring the code,
> I
> > > >> > believe I
> > > >> > > > am
> > > >> > > > > >>>> ready
> > > >> > > > > >>>>> to start specific changes in the code.
> > > >> > > > > >>>>>
> > > >> > > > > >>>>> So am sending this message to ask you, if some of you
> > have
> > > >> > ideas
> > > >> > > > > >> about
> > > >> > > > > >>>>> features or improvement and you want one more for
> help.
> > > >> > > > > >>>>>
> > > >> > > > > >>>>> Also if you have some issues you want some help please
> > let
> > > >> me
> > > >> > > know
> > > >> > > > > >>> (jira
> > > >> > > > > >>>>> account chrikon).
> > > >> > > > > >>>>>
> > > >> > > > > >>>>> Thanks in advance,
> > > >> > > > > >>>>>
> > > >> > > > > >>>>> Regards
> > > >> > > > > >>>>> Christos
> > > >> > > > > >>>>>
> > > >> > > > > >>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <
> > > >> > > > > >>>> chrikon1994@gmail.com>
> > > >> > > > > >>>>> wrote:
> > > >> > > > > >>>>>
> > > >> > > > > >>>>>> Sorry Hadrian thank you for your correction, this
> will
> > > not
> > > >> > > happen
> > > >> > > > > >>> again!
> > > >> > > > > >>>>>>
> > > >> > > > > >>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <
> > > >> > > > > >> hzbarcea@gmail.com>
> > > >> > > > > >>>>>> wrote:
> > > >> > > > > >>>>>>
> > > >> > > > > >>>>>>> Hi Christos,
> > > >> > > > > >>>>>>>
> > > >> > > > > >>>>>>> First off, I am not a Mister :), just Hadrian.
> > > >> > > > > >>>>>>>
> > > >> > > > > >>>>>>> Yes, the idea is to collaborate, that's what open
> > source
> > > >> is
> > > >> > > > about.
> > > >> > > > > >>>>>>>
> > > >> > > > > >>>>>>> Good luck,
> > > >> > > > > >>>>>>> Hadrian
> > > >> > > > > >>>>>>>
> > > >> > > > > >>>>>>>
> > > >> > > > > >>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
> > > >> > > > > >>>>>>>
> > > >> > > > > >>>>>>>> Firstly thank you all for your suggestions, all of
> > them
> > > >> are
> > > >> > > very
> > > >> > > > > >>>> helpful.
> > > >> > > > > >>>>>>>>
> > > >> > > > > >>>>>>>> In this moment I follow the very good advice and I
> am
> > > >> > reading
> > > >> > > > > >>>>>>>> documentation, because next Wednesday I have to
> make
> > a
> > > >> > > > > >> presentation
> > > >> > > > > >>>> for
> > > >> > > > > >>>>>>>> tinkerpop in front of my class!
> > > >> > > > > >>>>>>>>
> > > >> > > > > >>>>>>>> Marko I have to write code for my assignment, but
> in
> > my
> > > >> free
> > > >> > > > time
> > > >> > > > > >> it
> > > >> > > > > >>>> is
> > > >> > > > > >>>>>>>> an
> > > >> > > > > >>>>>>>> interesting work.
> > > >> > > > > >>>>>>>>
> > > >> > > > > >>>>>>>> Although Javadoc it is applicable to my
> assignment, I
> > > >> > think. I
> > > >> > > > > >> will
> > > >> > > > > >>>> ask
> > > >> > > > > >>>>>>>> and
> > > >> > > > > >>>>>>>> I will have news.
> > > >> > > > > >>>>>>>>
> > > >> > > > > >>>>>>>> If Mr. Hadrian Zbarcea are working on it, I would
> > like
> > > >> not
> > > >> > to
> > > >> > > > > >>>> interfere
> > > >> > > > > >>>>>>>> in
> > > >> > > > > >>>>>>>> your job, or we can cooperate.
> > > >> > > > > >>>>>>>> Before that discussion I have to contact to my
> > academic
> > > >> > > > supervisor
> > > >> > > > > >>> in
> > > >> > > > > >>>>>>>> order
> > > >> > > > > >>>>>>>> to be 100% sure that this is ok.
> > > >> > > > > >>>>>>>>
> > > >> > > > > >>>>>>>> P.S. I hope my English is at least understandable,
> if
> > > >> not so
> > > >> > > > > >> please
> > > >> > > > > >>>> ask
> > > >> > > > > >>>>>>>> me
> > > >> > > > > >>>>>>>> again.
> > > >> > > > > >>>>>>>>
> > > >> > > > > >>>>>>>> Thank you all.
> > > >> > > > > >>>>>>>> Christos
> > > >> > > > > >>>>>>>>
> > > >> > > > > >>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <
> > > >> > > > > >>> hzbarcea@gmail.com>
> > > >> > > > > >>>>>>>> wrote:
> > > >> > > > > >>>>>>>>
> > > >> > > > > >>>>>>>> That's something I am interested in too.
> > > >> > > > > >>>>>>>>> Hadrian
> > > >> > > > > >>>>>>>>>
> > > >> > > > > >>>>>>>>>
> > > >> > > > > >>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
> > > >> > > > > >>>>>>>>>
> > > >> > > > > >>>>>>>>> Hi Christos,
> > > >> > > > > >>>>>>>>>>
> > > >> > > > > >>>>>>>>>> Another thing that we need is more JavaDoc! Its
> not
> > > >> sexy,
> > > >> > > but
> > > >> > > > > >> boy
> > > >> > > > > >>>> would
> > > >> > > > > >>>>>>>>>> be it be great to have someone go through and
> > > >> JavaDoc-up
> > > >> > > > > >>>> GraphTraversal
> > > >> > > > > >>>>>>>>>> (all those methods…).
> > > >> > > > > >>>>>>>>>>
> > > >> > > > > >>>>>>>>>>
> > > >> > https://github.com/apache/incubator-tinkerpop/blob/
> > > >> > > > > >>>>>>>>>>
> > > master/gremlin-core/src/main/java/org/apache/tinkerpop/
> > > >> > > > > >>>>>>>>>>
> > > gremlin/process/traversal/dsl/graph/GraphTraversal.java
> > > >> > > > > >>>>>>>>>>
> > > >> > > > > >>>>>>>>>> …the docs provide a description of each step.
> > > >> > > > > >>>>>>>>>>
> > > >> > > > > >>>>>>>>>>
> > > >> http://tinkerpop.incubator.apache.org/docs/3.0.0-
> > > >> > > > > >>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct
> > clicking
> > > to
> > > >> > any
> > > >> > > > > >>>> particular
> > > >> > > > > >>>>>>>>>> step)
> > > >> > > > > >>>>>>>>>>
> > > >> > > > > >>>>>>>>>> I would say that would be more helpful now than a
> > > >> "Through
> > > >> > > the
> > > >> > > > > >>>>>>>>>> TinkerPop"-tutorial.
> > > >> > > > > >>>>>>>>>>
> > > >> > > > > >>>>>>>>>> Finally, what else would be helpful --- more test
> > > >> cases.
> > > >> > If
> > > >> > > > you
> > > >> > > > > >>> are
> > > >> > > > > >>>>>>>>>> interested in testing, I can get your set up in
> > with
> > > "a
> > > >> > > > pattern"
> > > >> > > > > >>> so
> > > >> > > > > >>>>>>>>>> you pop
> > > >> > > > > >>>>>>>>>> out more process/ tests. For example:
> > > >> > > > > >>>>>>>>>>
> > > >> > > > > >>>>>>>>>>
> > > >> > https://github.com/apache/incubator-tinkerpop/blob/
> > > >> > > > > >>>>>>>>>>
> > > master/gremlin-test/src/main/java/org/apache/tinkerpop/
> > > >> > > > > >>>>>>>>>> gremlin/process/traversal/step/map/CountTest.java
> > > >> > > > > >>>>>>>>>>
> > > >> > > > > >>>>>>>>>> Thanks,
> > > >> > > > > >>>>>>>>>> Marko.
> > > >> > > > > >>>>>>>>>>
> > > >> > > > > >>>>>>>>>> http://markorodriguez.com
> > > >> > > > > >>>>>>>>>>
> > > >> > > > > >>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <
> > > >> > > > > >>> okrammarko@gmail.com>
> > > >> > > > > >>>>>>>>>> wrote:
> > > >> > > > > >>>>>>>>>>
> > > >> > > > > >>>>>>>>>> Hi Christos,
> > > >> > > > > >>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>> Are you interested in writing code or perhaps,
> > > >> writing a
> > > >> > > > > >>> tutorial?
> > > >> > > > > >>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>> It would be nice to have an in-depth tutorial on
> > > >> > > TinkerPop3.
> > > >> > > > > >> For
> > > >> > > > > >>>>>>>>>>> instance, find a reasonably sized dataset (<1
> > > million
> > > >> > > edges),
> > > >> > > > > >>> parse
> > > >> > > > > >>>>>>>>>>> it into
> > > >> > > > > >>>>>>>>>>> a graph, do some analysis on it, expose it via
> > > Gremlin
> > > >> > > > Server,
> > > >> > > > > >>> OLTP
> > > >> > > > > >>>>>>>>>>> and
> > > >> > > > > >>>>>>>>>>> OLAP queries hitting it, etc. Write up the path
> > you
> > > >> took
> > > >> > > into
> > > >> > > > > >> an
> > > >> > > > > >>>>>>>>>>> AsciiDoc
> > > >> > > > > >>>>>>>>>>> and we could put it on the Apache TinkerPop site
> > as
> > > a
> > > >> > > > "Through
> > > >> > > > > >>> the
> > > >> > > > > >>>>>>>>>>> TinkerPop" tutorial. Be great if you could touch
> > on
> > > >> every
> > > >> > > > > >> aspect
> > > >> > > > > >>> of
> > > >> > > > > >>>>>>>>>>> the
> > > >> > > > > >>>>>>>>>>> TinkerPop framework in the tutorial.
> > > >> > > > > >>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>> I would appreciate a contribution like that.
> > > >> > > > > >>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>> Thanks,
> > > >> > > > > >>>>>>>>>>> Marko.
> > > >> > > > > >>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>> http://markorodriguez.com
> > > >> > > > > >>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
> > > >> > > > > >>>> m.ben.franklin@gmail.com>
> > > >> > > > > >>>>>>>>>>> wrote:
> > > >> > > > > >>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen
> Mallette <
> > > >> > > > > >>>>>>>>>>> spmallette@gmail.com>
> > > >> > > > > >>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>> wrote:
> > > >> > > > > >>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>> My suggestion would be for you to spend some
> time
> > > >> > learning
> > > >> > > > > >>> about
> > > >> > > > > >>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>> TinkerPop
> > > >> > > > > >>>>>>>>>>>>> (reading the documentation, examining the code
> > > base,
> > > >> > > > perusing
> > > >> > > > > >>> the
> > > >> > > > > >>>>>>>>>>>>> Jira
> > > >> > > > > >>>>>>>>>>>>> issue tracker, etc.) to determine if any
> > > particular
> > > >> > part
> > > >> > > of
> > > >> > > > > >> the
> > > >> > > > > >>>>>>>>>>>>> stack
> > > >> > > > > >>>>>>>>>>>>> interests you.
> > > >> > > > > >>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>> IMO, there is no better way to get involved
> than
> > to
> > > >> pick
> > > >> > > > > >>> something
> > > >> > > > > >>>>>>>>>>>> that
> > > >> > > > > >>>>>>>>>>>> needs to be worked on and provide a patch for
> it.
> > > I
> > > >> > would
> > > >> > > > > >> look
> > > >> > > > > >>> at
> > > >> > > > > >>>>>>>>>>>> JIRA
> > > >> > > > > >>>>>>>>>>>> and
> > > >> > > > > >>>>>>>>>>>> find an issue that interests you.
> > > >> > > > > >>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>> In doing that, you might develop your own ideas
> > as
> > > to
> > > >> > > > > >>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>> where/what you think you are best suited to
> > > >> contribute.
> > > >> > > At
> > > >> > > > > >>> that
> > > >> > > > > >>>>>>>>>>>>> point
> > > >> > > > > >>>>>>>>>>>>> you
> > > >> > > > > >>>>>>>>>>>>> could post those ideas here in the mailing
> list
> > > for
> > > >> > > > feedback.
> > > >> > > > > >>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos
> > > Oikonomou
> > > >> <
> > > >> > > > > >>>>>>>>>>>>> chrikon1994@gmail.com
> > > >> > > > > >>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>> wrote:
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>> Hi Stephen
> > > >> > > > > >>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>> When I start I was not familiar with the
> > project
> > > >> nor
> > > >> > the
> > > >> > > > > >>>>>>>>>>>>>> architecture/codebase.
> > > >> > > > > >>>>>>>>>>>>>> But I am reading about tinkerpop and
> searching
> > in
> > > >> the
> > > >> > > code
> > > >> > > > > >> and
> > > >> > > > > >>>>>>>>>>>>>> I am thinking to make some simple examples in
> > > >> order to
> > > >> > > be
> > > >> > > > > >> more
> > > >> > > > > >>>>>>>>>>>>>> familiar
> > > >> > > > > >>>>>>>>>>>>>> with the functionality.
> > > >> > > > > >>>>>>>>>>>>>> So I am not now very familiar but I try to be
> > in
> > > >> the
> > > >> > > near
> > > >> > > > > >>>> future.
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>> Christos
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen
> > > Mallette <
> > > >> > > > > >>>>>>>>>>>>>> spmallette@gmail.com>
> > > >> > > > > >>>>>>>>>>>>>> wrote:
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>> Hi Christos, we appreciate your offer to
> > > >> contribute.
> > > >> > > > Could
> > > >> > > > > >>> you
> > > >> > > > > >>>>>>>>>>>>>> tell
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>> us
> > > >> > > > > >>>>>>>>>>>>>>> what kind of experience you have with
> > TinkerPop
> > > so
> > > >> > far?
> > > >> > > > > >> Are
> > > >> > > > > >>>> you
> > > >> > > > > >>>>>>>>>>>>>>> at
> > > >> > > > > >>>>>>>>>>>>>>> all
> > > >> > > > > >>>>>>>>>>>>>>> familiar with the architecture/codebase?
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>> Stephen
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos
> > > >> Oikonomou
> > > >> > <
> > > >> > > > > >>>>>>>>>>>>>>> chrikon1994@gmail.com>
> > > >> > > > > >>>>>>>>>>>>>>> wrote:
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>> Dear Tinkerpop Development Team
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>> My name is Christos Economou.
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>> I would like to contribute in the
> tinkerpop3.
> > > >> > > > > >>>>>>>>>>>>>>>> This contribution will be a part of an
> > > >> assignment in
> > > >> > > one
> > > >> > > > > >> of
> > > >> > > > > >>> my
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>> classes.
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>> I am in my third year of study at Athens
> > > >> University of
> > > >> > > > > >>> Economics
> > > >> > > > > >>>>>>>>>>>>>>>> and
> > > >> > > > > >>>>>>>>>>>>>>>> Business (Greece | Hellas).In this
> semester I
> > > >> attend
> > > >> > > in
> > > >> > > > > >>>> lectures
> > > >> > > > > >>>>>>>>>>>>>>>> that
> > > >> > > > > >>>>>>>>>>>>>>>> called "Advanced Topics in Software
> > > Engineering"
> > > >> by
> > > >> > > > > >>> professor
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>> Diomidis
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>> Spinellis.
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>> As assignment I have to contribute in an
> open
> > > >> source
> > > >> > > > > >>> project.
> > > >> > > > > >>>> I
> > > >> > > > > >>>>>>>>>>>>>>>> would
> > > >> > > > > >>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3. More
> > > >> > specifically
> > > >> > > I
> > > >> > > > > >>>>>>>>>>>>>>>> understand
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>> that
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>> in
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>> big projects, like this, always exists work
> on
> > > >> > > > integration
> > > >> > > > > >>> and
> > > >> > > > > >>>>>>>>>>>>>>>> collaboration between components and
> > > subsystems.
> > > >> So
> > > >> > I
> > > >> > > do
> > > >> > > > > >> not
> > > >> > > > > >>>> have
> > > >> > > > > >>>>>>>>>>>>>>>> any
> > > >> > > > > >>>>>>>>>>>>>>>> problem to work on that. But I am more
> > > >> interested in
> > > >> > > > > >>> creative
> > > >> > > > > >>>>>>>>>>>>>>>> work
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>> like
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>> implementation of some algorithm or on a new
> > > >> > > functionality.
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>> I have to mention I have a hard constraint,
> > > that
> > > >> my
> > > >> > > > > >>>> contribution
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>> should
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>> be
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>> at least 100 - 200 lines of code.
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>> So I am writing you to ask if you have in
> > mind
> > > >> some
> > > >> > > > > >>>>>>>>>>>>>>>> functionalities
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>> that
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>> I
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>> can help in development. Here some
> information
> > > >> about
> > > >> > my
> > > >> > > > > >>>>>>>>>>>>>>>> knowledge in
> > > >> > > > > >>>>>>>>>>>>>>>> software engineering and programming
> > languages
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>> inetpub/detfolio/.
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>> Thank you for your time and attention.
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>> Regards,
> > > >> > > > > >>>>>>>>>>>>>>>> Christos Oikonomou
> > > >> > > > > >>>>>>>>>>>>>>>> Assistant researcher at ISTLab
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
> > > >> > > > > >>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>>
> > > >> > > > > >>>>>>>>>>
> > > >> > > > > >>>>>>>>>>
> > > >> > > > > >>>>>>>>
> > > >> > > > > >>>>>>
> > > >> > > > > >>>>
> > > >> > > > > >>>>
> > > >> > > > > >>>
> > > >> > > > > >>
> > > >> > > > >
> > > >> > > > >
> > > >> > > >
> > > >> > >
> > > >> >
> > > >>
> > > >
> > > >
> > >
> >
>
Re: Contributing to tinkerpop3
Posted by Christos Oikonomou <ch...@gmail.com>.
Hello Stephen,
I thought that it would be better to avoid reading url if we provide the
.html in the release zip.
That's why I thought to create two methods to read the javadocs locally
(why I need the path) or if that fails to go to url. I f you believe that
is not necessary this works fine for me also because it is a lot of work.
But this operation will not work off line.
For the repo yes I have one folk but I have not finnish all the
documentation and junit so I have not push yet, when I do I will send you
the link.
Regards,
Christos
On Tue, May 26, 2015 at 2:44 PM, Stephen Mallette <sp...@gmail.com>
wrote:
> Hi Christos - I assume that you have a fork of TinkerPop3 somewhere?
> Perhaps you could point us to your code so that we can see what you've
> done? It might be easier to discuss if we could see that. Also, it would
> be helpful to know more about your proposed syntax to your commands and
> what they will do.
>
> > Secondly what is the correct path for the javadoc in release and in
> development
> version?
>
> We deploy javadocs for every official release and for the current
> SNAPSHOT. The Console can find the current version by calling
> Gremlin.version() - you should be able to use that to construct the right
> URL to the javadoc. I think that would work.
>
>
>
> On Mon, May 25, 2015 at 9:15 AM, Christos Oikonomou <chrikon1994@gmail.com
> >
> wrote:
>
> > Hello everyone
> >
> > I was working on Java displaying in gremlin console.
> > I have came to a point that I need your guidance.
> > I have made 3 classes one for importing, for Doc structure in a class and
> > third for the structure of the data in a method.
> >
> > Also I add 2 commands in groovy the ImportDocsCommand and DicsCommand.
> The
> > first impliment the import of the javadocs of a class for the Class.html
> > and the second the displaying.
> >
> > Firstly what are your thoughts for those,
> >
> > Secondly what is the correct path for the javadoc in release and in
> > development version?
> >
> > Regards
> > Christos
> >
> > On Sat, Apr 25, 2015 at 2:59 PM, Christos Oikonomou <
> chrikon1994@gmail.com
> > >
> > wrote:
> >
> > > I thought we can create an doc.xml with all the relative information
> > > gathered for every function.
> > >
> > > Although I see your point.
> > >
> > > But I like also the idea of Matt.....
> > >
> > > As I see this was something that interest you so I will start working
> on
> > > how that should be implemented.
> > >
> > > Regards,
> > > Christos
> > >
> > > On Sat, Apr 25, 2015 at 1:35 PM, Stephen Mallette <
> spmallette@gmail.com>
> > > wrote:
> > >
> > >> Matt, I like idea for a :docimport command. By default we would load
> > >> GraphTraversal into it so that
> > >>
> > >> gremlin> :doc outE
> > >>
> > >> could resolve to the appropriate javadoc right out the box. It is
> > >> generally applicable and as you say might even be of interest to the
> > >> groovy
> > >> project at some point.
> > >>
> > >> Christos, I think the categories you mention are good, but I would
> take
> > >> care to consider the source of the documentation. Where would those
> > >> categories come from for you to display them? I don't think it would
> be
> > >> especially helpful if we had to manage javadoc, the asciidoc and then
> > >> another class of documentation for the console. I think that
> > re-purposing
> > >> the javadoc is the best approach here and if we write some good
> javadoc
> > we
> > >> will roughly cover your categories. You could obviously display the
> > text
> > >> of the javadoc, which would likely cover your first two categories (if
> > >> written well). For the links, we could add @see tags as needed to the
> > >> javadoc and those would be the links to display in the console.
> > >>
> > >>
> > >>
> > >>
> > >>
> > >> On Fri, Apr 24, 2015 at 7:13 PM, Christos Oikonomou <
> > >> chrikon1994@gmail.com>
> > >> wrote:
> > >>
> > >> > I am glad for your reaction.
> > >> > I was thinking that we can display the information in 4 categories
> > >> >
> > >> > gremlin> :doc foo
> > >> > Description of Functionality
> > >> > .....
> > >> > Some relevant functionalities
> > >> > ......
> > >> > Link to the user documentation
> > >> > ......
> > >> > Link to the javadoc
> > >> > .........
> > >> >
> > >> > Do you believe that informations will be clear to all kinds of users
> > >> >
> > >> > On Sat, Apr 25, 2015 at 12:36 AM, Matt Frantz <
> > >> matthew.h.frantz@gmail.com>
> > >> > wrote:
> > >> >
> > >> > > Perhaps there should be a command to import the javadocs for a
> > >> particular
> > >> > > package or interface, e.g. a DSL interface. The effect would be
> to
> > >> haul
> > >> > > the methods into the global doc namespace. By default, we would
> > apply
> > >> > that
> > >> > > to GraphTraversal.
> > >> > >
> > >> > > gremlin> :doc outE
> > >> > > TODO: Write a good javadoc for each GraphTraversal method
> > >> > > gremlin> :importdoc TinkerFactory.SocialTraversal
> > >> > > gremlin> :doc people
> > >> > > TODO: Write a good javadoc for each SocialTraversal method
> > >> > >
> > >> > > It could be applied to any class or interface. Applying it to a
> > >> package
> > >> > > would haul the classes and subpackages into the global doc
> > namespace.
> > >> > >
> > >> > > gremlin> :importdoc
> > org.apache.tinkerpop.gremlin.tinkergraph.structure
> > >> > > gremlin> :doc TinkerHelper
> > >> > > gremlin> :doc TinkerHelper.queryVertexIndex
> > >> > >
> > >> > > Maybe you could allow fully-qualified resolution without an
> import:
> > >> > >
> > >> > > gremlin> :doc
> > >> > >
> > >> > >
> > >> >
> > >>
> >
> org.apache.tinkerpop.gremlin.tinkergraph.structure.TinkerHelper.queryVertexIndex
> > >> > >
> > >> > > This seems like something that could be contributed upstream to
> the
> > >> > Groovy
> > >> > > REPL.
> > >> > >
> > >> > > On Fri, Apr 24, 2015 at 12:10 PM, Stephen Mallette <
> > >> spmallette@gmail.com
> > >> > >
> > >> > > wrote:
> > >> > >
> > >> > > > Yeah - it would be straightforward to bring in javadoc for the
> > most
> > >> > part:
> > >> > > >
> > >> > > > gremlin> :doc EdgeVertexStep
> > >> > > >
> > >> > > > you can get the class from that and full package name with
> > >> reflection
> > >> > > then
> > >> > > > translate it to javadoc to extract some text to display in the
> > >> console.
> > >> > > I
> > >> > > > guess that's nice, but no one knows VertexStep. They know this
> > step
> > >> > > > though:
> > >> > > >
> > >> > > > gremlin> :doc outE
> > >> > > >
> > >> > > > So - I guess the question is how one would go from just a pure
> > >> javadoc
> > >> > > > lookup command (cool but a bit less useful to a first time user
> > who
> > >> > > doesn't
> > >> > > > know the classes - not that EdgeVertexStep would yield anything
> > >> about
> > >> > > outE
> > >> > > > for that matter as it sits) to something that gives the user
> > >> content on
> > >> > > > steps from GraphTraversal which is the core of the DSL. And
> then
> > -
> > >> how
> > >> > > > would it extend to other DSLs so that it was generally
> applicable
> > to
> > >> > > those
> > >> > > > extending the language.
> > >> > > >
> > >> > > >
> > >> > > >
> > >> > > > On Fri, Apr 24, 2015 at 3:02 PM, Marko Rodriguez <
> > >> okrammarko@gmail.com
> > >> > >
> > >> > > > wrote:
> > >> > > >
> > >> > > > > That would be really classy. It would be cool if that could be
> > >> read
> > >> > > from
> > >> > > > > the JavaDoc somehow………… then we kill two birds with one stone.
> > >> > > > >
> > >> > > > > Marko.
> > >> > > > >
> > >> > > > > http://markorodriguez.com
> > >> > > > >
> > >> > > > > On Apr 24, 2015, at 12:08 PM, Stephen Mallette <
> > >> spmallette@gmail.com
> > >> > >
> > >> > > > > wrote:
> > >> > > > >
> > >> > > > > >> A gremlin-command that display in gremlin-console user
> > >> > documentation
> > >> > > > or
> > >> > > > > > javadocs of a gremlin functionality could be something that
> > >> helps
> > >> > > user?
> > >> > > > > >
> > >> > > > > > That's an interesting idea. I assume you are suggesting
> > >> something
> > >> > > > like:
> > >> > > > > >
> > >> > > > > > gremlin> :doc choose
> > >> > > > > > ==>The choose()-step (branch) routes the current traverser
> to
> > a
> > >> > > > > particular
> > >> > > > > > traversal branch option. With choose(), it is possible to
> > >> > > > implement......
> > >> > > > > >
> > >> > > > > > Is that what you mean?
> > >> > > > > >
> > >> > > > > >
> > >> > > > > >
> > >> > > > > >
> > >> > > > > > On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <
> > >> > > > > chrikon1994@gmail.com>
> > >> > > > > > wrote:
> > >> > > > > >
> > >> > > > > >> Hello and sorry for the delay. Thanks for the answers.
> > >> > > > > >> I have done a general overview of all the code base. But
> more
> > >> > > > > familiarized
> > >> > > > > >> I am in gremlin-core and gremlin-console.
> > >> > > > > >> I prefer the assignment of issues because I wants to help
> > also
> > >> to
> > >> > > the
> > >> > > > > >> faster achievement of the project planning in general.
> > >> > > > > >> Also I have an idea in documentation. A gremlin-command
> that
> > >> > display
> > >> > > > in
> > >> > > > > >> gremlin-console user documentation or javadocs of a gremlin
> > >> > > > > functionality
> > >> > > > > >> could be something that helps user?
> > >> > > > > >>
> > >> > > > > >> Regards,
> > >> > > > > >> Christos
> > >> > > > > >>
> > >> > > > > >> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <
> > >> > > > > m.ben.franklin@gmail.com>
> > >> > > > > >> wrote:
> > >> > > > > >>
> > >> > > > > >>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <
> > >> > > > okrammarko@gmail.com>
> > >> > > > > >>> wrote:
> > >> > > > > >>>
> > >> > > > > >>>> Hi Christos,
> > >> > > > > >>>>
> > >> > > > > >>>> Given that you have familiarized yourself with the
> > codebase,
> > >> > which
> > >> > > > > area
> > >> > > > > >>> of
> > >> > > > > >>>> the codebase do you feel:
> > >> > > > > >>>>
> > >> > > > > >>>> 1. you understand the best, and
> > >> > > > > >>>> 2. are interested in working on.
> > >> > > > > >>>>
> > >> > > > > >>>> Given that information, I will be able to figure out
> > >> something
> > >> > > > > >> particular
> > >> > > > > >>>> for you to do.
> > >> > > > > >>>>
> > >> > > > > >>>
> > >> > > > > >>> You should also feel free to pick an issue off of JIRA
> > >> yourself,
> > >> > or
> > >> > > > > even
> > >> > > > > >>> create an issue and submit a patch for it.
> > >> > > > > >>>
> > >> > > > > >>>
> > >> > > > > >>>>
> > >> > > > > >>>> Thanks,
> > >> > > > > >>>> Marko.
> > >> > > > > >>>>
> > >> > > > > >>>> http://markorodriguez.com
> > >> > > > > >>>>
> > >> > > > > >>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
> > >> > > > > >> chrikon1994@gmail.com>
> > >> > > > > >>>> wrote:
> > >> > > > > >>>>
> > >> > > > > >>>>> Hello everyone,
> > >> > > > > >>>>>
> > >> > > > > >>>>> I have read your advices how to start and how to be
> > >> > familiarized
> > >> > > > with
> > >> > > > > >>> the
> > >> > > > > >>>>> codebase. After some time I spent exploring the code, I
> > >> > believe I
> > >> > > > am
> > >> > > > > >>>> ready
> > >> > > > > >>>>> to start specific changes in the code.
> > >> > > > > >>>>>
> > >> > > > > >>>>> So am sending this message to ask you, if some of you
> have
> > >> > ideas
> > >> > > > > >> about
> > >> > > > > >>>>> features or improvement and you want one more for help.
> > >> > > > > >>>>>
> > >> > > > > >>>>> Also if you have some issues you want some help please
> let
> > >> me
> > >> > > know
> > >> > > > > >>> (jira
> > >> > > > > >>>>> account chrikon).
> > >> > > > > >>>>>
> > >> > > > > >>>>> Thanks in advance,
> > >> > > > > >>>>>
> > >> > > > > >>>>> Regards
> > >> > > > > >>>>> Christos
> > >> > > > > >>>>>
> > >> > > > > >>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <
> > >> > > > > >>>> chrikon1994@gmail.com>
> > >> > > > > >>>>> wrote:
> > >> > > > > >>>>>
> > >> > > > > >>>>>> Sorry Hadrian thank you for your correction, this will
> > not
> > >> > > happen
> > >> > > > > >>> again!
> > >> > > > > >>>>>>
> > >> > > > > >>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <
> > >> > > > > >> hzbarcea@gmail.com>
> > >> > > > > >>>>>> wrote:
> > >> > > > > >>>>>>
> > >> > > > > >>>>>>> Hi Christos,
> > >> > > > > >>>>>>>
> > >> > > > > >>>>>>> First off, I am not a Mister :), just Hadrian.
> > >> > > > > >>>>>>>
> > >> > > > > >>>>>>> Yes, the idea is to collaborate, that's what open
> source
> > >> is
> > >> > > > about.
> > >> > > > > >>>>>>>
> > >> > > > > >>>>>>> Good luck,
> > >> > > > > >>>>>>> Hadrian
> > >> > > > > >>>>>>>
> > >> > > > > >>>>>>>
> > >> > > > > >>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
> > >> > > > > >>>>>>>
> > >> > > > > >>>>>>>> Firstly thank you all for your suggestions, all of
> them
> > >> are
> > >> > > very
> > >> > > > > >>>> helpful.
> > >> > > > > >>>>>>>>
> > >> > > > > >>>>>>>> In this moment I follow the very good advice and I am
> > >> > reading
> > >> > > > > >>>>>>>> documentation, because next Wednesday I have to make
> a
> > >> > > > > >> presentation
> > >> > > > > >>>> for
> > >> > > > > >>>>>>>> tinkerpop in front of my class!
> > >> > > > > >>>>>>>>
> > >> > > > > >>>>>>>> Marko I have to write code for my assignment, but in
> my
> > >> free
> > >> > > > time
> > >> > > > > >> it
> > >> > > > > >>>> is
> > >> > > > > >>>>>>>> an
> > >> > > > > >>>>>>>> interesting work.
> > >> > > > > >>>>>>>>
> > >> > > > > >>>>>>>> Although Javadoc it is applicable to my assignment, I
> > >> > think. I
> > >> > > > > >> will
> > >> > > > > >>>> ask
> > >> > > > > >>>>>>>> and
> > >> > > > > >>>>>>>> I will have news.
> > >> > > > > >>>>>>>>
> > >> > > > > >>>>>>>> If Mr. Hadrian Zbarcea are working on it, I would
> like
> > >> not
> > >> > to
> > >> > > > > >>>> interfere
> > >> > > > > >>>>>>>> in
> > >> > > > > >>>>>>>> your job, or we can cooperate.
> > >> > > > > >>>>>>>> Before that discussion I have to contact to my
> academic
> > >> > > > supervisor
> > >> > > > > >>> in
> > >> > > > > >>>>>>>> order
> > >> > > > > >>>>>>>> to be 100% sure that this is ok.
> > >> > > > > >>>>>>>>
> > >> > > > > >>>>>>>> P.S. I hope my English is at least understandable, if
> > >> not so
> > >> > > > > >> please
> > >> > > > > >>>> ask
> > >> > > > > >>>>>>>> me
> > >> > > > > >>>>>>>> again.
> > >> > > > > >>>>>>>>
> > >> > > > > >>>>>>>> Thank you all.
> > >> > > > > >>>>>>>> Christos
> > >> > > > > >>>>>>>>
> > >> > > > > >>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <
> > >> > > > > >>> hzbarcea@gmail.com>
> > >> > > > > >>>>>>>> wrote:
> > >> > > > > >>>>>>>>
> > >> > > > > >>>>>>>> That's something I am interested in too.
> > >> > > > > >>>>>>>>> Hadrian
> > >> > > > > >>>>>>>>>
> > >> > > > > >>>>>>>>>
> > >> > > > > >>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
> > >> > > > > >>>>>>>>>
> > >> > > > > >>>>>>>>> Hi Christos,
> > >> > > > > >>>>>>>>>>
> > >> > > > > >>>>>>>>>> Another thing that we need is more JavaDoc! Its not
> > >> sexy,
> > >> > > but
> > >> > > > > >> boy
> > >> > > > > >>>> would
> > >> > > > > >>>>>>>>>> be it be great to have someone go through and
> > >> JavaDoc-up
> > >> > > > > >>>> GraphTraversal
> > >> > > > > >>>>>>>>>> (all those methods…).
> > >> > > > > >>>>>>>>>>
> > >> > > > > >>>>>>>>>>
> > >> > https://github.com/apache/incubator-tinkerpop/blob/
> > >> > > > > >>>>>>>>>>
> > master/gremlin-core/src/main/java/org/apache/tinkerpop/
> > >> > > > > >>>>>>>>>>
> > gremlin/process/traversal/dsl/graph/GraphTraversal.java
> > >> > > > > >>>>>>>>>>
> > >> > > > > >>>>>>>>>> …the docs provide a description of each step.
> > >> > > > > >>>>>>>>>>
> > >> > > > > >>>>>>>>>>
> > >> http://tinkerpop.incubator.apache.org/docs/3.0.0-
> > >> > > > > >>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct
> clicking
> > to
> > >> > any
> > >> > > > > >>>> particular
> > >> > > > > >>>>>>>>>> step)
> > >> > > > > >>>>>>>>>>
> > >> > > > > >>>>>>>>>> I would say that would be more helpful now than a
> > >> "Through
> > >> > > the
> > >> > > > > >>>>>>>>>> TinkerPop"-tutorial.
> > >> > > > > >>>>>>>>>>
> > >> > > > > >>>>>>>>>> Finally, what else would be helpful --- more test
> > >> cases.
> > >> > If
> > >> > > > you
> > >> > > > > >>> are
> > >> > > > > >>>>>>>>>> interested in testing, I can get your set up in
> with
> > "a
> > >> > > > pattern"
> > >> > > > > >>> so
> > >> > > > > >>>>>>>>>> you pop
> > >> > > > > >>>>>>>>>> out more process/ tests. For example:
> > >> > > > > >>>>>>>>>>
> > >> > > > > >>>>>>>>>>
> > >> > https://github.com/apache/incubator-tinkerpop/blob/
> > >> > > > > >>>>>>>>>>
> > master/gremlin-test/src/main/java/org/apache/tinkerpop/
> > >> > > > > >>>>>>>>>> gremlin/process/traversal/step/map/CountTest.java
> > >> > > > > >>>>>>>>>>
> > >> > > > > >>>>>>>>>> Thanks,
> > >> > > > > >>>>>>>>>> Marko.
> > >> > > > > >>>>>>>>>>
> > >> > > > > >>>>>>>>>> http://markorodriguez.com
> > >> > > > > >>>>>>>>>>
> > >> > > > > >>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <
> > >> > > > > >>> okrammarko@gmail.com>
> > >> > > > > >>>>>>>>>> wrote:
> > >> > > > > >>>>>>>>>>
> > >> > > > > >>>>>>>>>> Hi Christos,
> > >> > > > > >>>>>>>>>>
> > >> > > > > >>>>>>>>>>>
> > >> > > > > >>>>>>>>>>> Are you interested in writing code or perhaps,
> > >> writing a
> > >> > > > > >>> tutorial?
> > >> > > > > >>>>>>>>>>>
> > >> > > > > >>>>>>>>>>> It would be nice to have an in-depth tutorial on
> > >> > > TinkerPop3.
> > >> > > > > >> For
> > >> > > > > >>>>>>>>>>> instance, find a reasonably sized dataset (<1
> > million
> > >> > > edges),
> > >> > > > > >>> parse
> > >> > > > > >>>>>>>>>>> it into
> > >> > > > > >>>>>>>>>>> a graph, do some analysis on it, expose it via
> > Gremlin
> > >> > > > Server,
> > >> > > > > >>> OLTP
> > >> > > > > >>>>>>>>>>> and
> > >> > > > > >>>>>>>>>>> OLAP queries hitting it, etc. Write up the path
> you
> > >> took
> > >> > > into
> > >> > > > > >> an
> > >> > > > > >>>>>>>>>>> AsciiDoc
> > >> > > > > >>>>>>>>>>> and we could put it on the Apache TinkerPop site
> as
> > a
> > >> > > > "Through
> > >> > > > > >>> the
> > >> > > > > >>>>>>>>>>> TinkerPop" tutorial. Be great if you could touch
> on
> > >> every
> > >> > > > > >> aspect
> > >> > > > > >>> of
> > >> > > > > >>>>>>>>>>> the
> > >> > > > > >>>>>>>>>>> TinkerPop framework in the tutorial.
> > >> > > > > >>>>>>>>>>>
> > >> > > > > >>>>>>>>>>> I would appreciate a contribution like that.
> > >> > > > > >>>>>>>>>>>
> > >> > > > > >>>>>>>>>>> Thanks,
> > >> > > > > >>>>>>>>>>> Marko.
> > >> > > > > >>>>>>>>>>>
> > >> > > > > >>>>>>>>>>> http://markorodriguez.com
> > >> > > > > >>>>>>>>>>>
> > >> > > > > >>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
> > >> > > > > >>>> m.ben.franklin@gmail.com>
> > >> > > > > >>>>>>>>>>> wrote:
> > >> > > > > >>>>>>>>>>>
> > >> > > > > >>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen Mallette <
> > >> > > > > >>>>>>>>>>> spmallette@gmail.com>
> > >> > > > > >>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>> wrote:
> > >> > > > > >>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>> My suggestion would be for you to spend some time
> > >> > learning
> > >> > > > > >>> about
> > >> > > > > >>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>> TinkerPop
> > >> > > > > >>>>>>>>>>>>> (reading the documentation, examining the code
> > base,
> > >> > > > perusing
> > >> > > > > >>> the
> > >> > > > > >>>>>>>>>>>>> Jira
> > >> > > > > >>>>>>>>>>>>> issue tracker, etc.) to determine if any
> > particular
> > >> > part
> > >> > > of
> > >> > > > > >> the
> > >> > > > > >>>>>>>>>>>>> stack
> > >> > > > > >>>>>>>>>>>>> interests you.
> > >> > > > > >>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>> IMO, there is no better way to get involved than
> to
> > >> pick
> > >> > > > > >>> something
> > >> > > > > >>>>>>>>>>>> that
> > >> > > > > >>>>>>>>>>>> needs to be worked on and provide a patch for it.
> > I
> > >> > would
> > >> > > > > >> look
> > >> > > > > >>> at
> > >> > > > > >>>>>>>>>>>> JIRA
> > >> > > > > >>>>>>>>>>>> and
> > >> > > > > >>>>>>>>>>>> find an issue that interests you.
> > >> > > > > >>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>> In doing that, you might develop your own ideas
> as
> > to
> > >> > > > > >>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>> where/what you think you are best suited to
> > >> contribute.
> > >> > > At
> > >> > > > > >>> that
> > >> > > > > >>>>>>>>>>>>> point
> > >> > > > > >>>>>>>>>>>>> you
> > >> > > > > >>>>>>>>>>>>> could post those ideas here in the mailing list
> > for
> > >> > > > feedback.
> > >> > > > > >>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos
> > Oikonomou
> > >> <
> > >> > > > > >>>>>>>>>>>>> chrikon1994@gmail.com
> > >> > > > > >>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>> wrote:
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>> Hi Stephen
> > >> > > > > >>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>> When I start I was not familiar with the
> project
> > >> nor
> > >> > the
> > >> > > > > >>>>>>>>>>>>>> architecture/codebase.
> > >> > > > > >>>>>>>>>>>>>> But I am reading about tinkerpop and searching
> in
> > >> the
> > >> > > code
> > >> > > > > >> and
> > >> > > > > >>>>>>>>>>>>>> I am thinking to make some simple examples in
> > >> order to
> > >> > > be
> > >> > > > > >> more
> > >> > > > > >>>>>>>>>>>>>> familiar
> > >> > > > > >>>>>>>>>>>>>> with the functionality.
> > >> > > > > >>>>>>>>>>>>>> So I am not now very familiar but I try to be
> in
> > >> the
> > >> > > near
> > >> > > > > >>>> future.
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>> Christos
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen
> > Mallette <
> > >> > > > > >>>>>>>>>>>>>> spmallette@gmail.com>
> > >> > > > > >>>>>>>>>>>>>> wrote:
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>> Hi Christos, we appreciate your offer to
> > >> contribute.
> > >> > > > Could
> > >> > > > > >>> you
> > >> > > > > >>>>>>>>>>>>>> tell
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>> us
> > >> > > > > >>>>>>>>>>>>>>> what kind of experience you have with
> TinkerPop
> > so
> > >> > far?
> > >> > > > > >> Are
> > >> > > > > >>>> you
> > >> > > > > >>>>>>>>>>>>>>> at
> > >> > > > > >>>>>>>>>>>>>>> all
> > >> > > > > >>>>>>>>>>>>>>> familiar with the architecture/codebase?
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>> Stephen
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos
> > >> Oikonomou
> > >> > <
> > >> > > > > >>>>>>>>>>>>>>> chrikon1994@gmail.com>
> > >> > > > > >>>>>>>>>>>>>>> wrote:
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>> Dear Tinkerpop Development Team
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>> My name is Christos Economou.
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>> I would like to contribute in the tinkerpop3.
> > >> > > > > >>>>>>>>>>>>>>>> This contribution will be a part of an
> > >> assignment in
> > >> > > one
> > >> > > > > >> of
> > >> > > > > >>> my
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>> classes.
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>> I am in my third year of study at Athens
> > >> University of
> > >> > > > > >>> Economics
> > >> > > > > >>>>>>>>>>>>>>>> and
> > >> > > > > >>>>>>>>>>>>>>>> Business (Greece | Hellas).In this semester I
> > >> attend
> > >> > > in
> > >> > > > > >>>> lectures
> > >> > > > > >>>>>>>>>>>>>>>> that
> > >> > > > > >>>>>>>>>>>>>>>> called "Advanced Topics in Software
> > Engineering"
> > >> by
> > >> > > > > >>> professor
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>> Diomidis
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>> Spinellis.
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>> As assignment I have to contribute in an open
> > >> source
> > >> > > > > >>> project.
> > >> > > > > >>>> I
> > >> > > > > >>>>>>>>>>>>>>>> would
> > >> > > > > >>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3. More
> > >> > specifically
> > >> > > I
> > >> > > > > >>>>>>>>>>>>>>>> understand
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>> that
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>> in
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>> big projects, like this, always exists work on
> > >> > > > integration
> > >> > > > > >>> and
> > >> > > > > >>>>>>>>>>>>>>>> collaboration between components and
> > subsystems.
> > >> So
> > >> > I
> > >> > > do
> > >> > > > > >> not
> > >> > > > > >>>> have
> > >> > > > > >>>>>>>>>>>>>>>> any
> > >> > > > > >>>>>>>>>>>>>>>> problem to work on that. But I am more
> > >> interested in
> > >> > > > > >>> creative
> > >> > > > > >>>>>>>>>>>>>>>> work
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>> like
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>> implementation of some algorithm or on a new
> > >> > > functionality.
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>> I have to mention I have a hard constraint,
> > that
> > >> my
> > >> > > > > >>>> contribution
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>> should
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>> be
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>> at least 100 - 200 lines of code.
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>> So I am writing you to ask if you have in
> mind
> > >> some
> > >> > > > > >>>>>>>>>>>>>>>> functionalities
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>> that
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>> I
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>> can help in development. Here some information
> > >> about
> > >> > my
> > >> > > > > >>>>>>>>>>>>>>>> knowledge in
> > >> > > > > >>>>>>>>>>>>>>>> software engineering and programming
> languages
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>> inetpub/detfolio/.
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>> Thank you for your time and attention.
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>> Regards,
> > >> > > > > >>>>>>>>>>>>>>>> Christos Oikonomou
> > >> > > > > >>>>>>>>>>>>>>>> Assistant researcher at ISTLab
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
> > >> > > > > >>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>>>
> > >> > > > > >>>>>>>>>>>
> > >> > > > > >>>>>>>>>>
> > >> > > > > >>>>>>>>>>
> > >> > > > > >>>>>>>>
> > >> > > > > >>>>>>
> > >> > > > > >>>>
> > >> > > > > >>>>
> > >> > > > > >>>
> > >> > > > > >>
> > >> > > > >
> > >> > > > >
> > >> > > >
> > >> > >
> > >> >
> > >>
> > >
> > >
> >
>
Re: Contributing to tinkerpop3
Posted by Stephen Mallette <sp...@gmail.com>.
Hi Christos - I assume that you have a fork of TinkerPop3 somewhere?
Perhaps you could point us to your code so that we can see what you've
done? It might be easier to discuss if we could see that. Also, it would
be helpful to know more about your proposed syntax to your commands and
what they will do.
> Secondly what is the correct path for the javadoc in release and in development
version?
We deploy javadocs for every official release and for the current
SNAPSHOT. The Console can find the current version by calling
Gremlin.version() - you should be able to use that to construct the right
URL to the javadoc. I think that would work.
On Mon, May 25, 2015 at 9:15 AM, Christos Oikonomou <ch...@gmail.com>
wrote:
> Hello everyone
>
> I was working on Java displaying in gremlin console.
> I have came to a point that I need your guidance.
> I have made 3 classes one for importing, for Doc structure in a class and
> third for the structure of the data in a method.
>
> Also I add 2 commands in groovy the ImportDocsCommand and DicsCommand. The
> first impliment the import of the javadocs of a class for the Class.html
> and the second the displaying.
>
> Firstly what are your thoughts for those,
>
> Secondly what is the correct path for the javadoc in release and in
> development version?
>
> Regards
> Christos
>
> On Sat, Apr 25, 2015 at 2:59 PM, Christos Oikonomou <chrikon1994@gmail.com
> >
> wrote:
>
> > I thought we can create an doc.xml with all the relative information
> > gathered for every function.
> >
> > Although I see your point.
> >
> > But I like also the idea of Matt.....
> >
> > As I see this was something that interest you so I will start working on
> > how that should be implemented.
> >
> > Regards,
> > Christos
> >
> > On Sat, Apr 25, 2015 at 1:35 PM, Stephen Mallette <sp...@gmail.com>
> > wrote:
> >
> >> Matt, I like idea for a :docimport command. By default we would load
> >> GraphTraversal into it so that
> >>
> >> gremlin> :doc outE
> >>
> >> could resolve to the appropriate javadoc right out the box. It is
> >> generally applicable and as you say might even be of interest to the
> >> groovy
> >> project at some point.
> >>
> >> Christos, I think the categories you mention are good, but I would take
> >> care to consider the source of the documentation. Where would those
> >> categories come from for you to display them? I don't think it would be
> >> especially helpful if we had to manage javadoc, the asciidoc and then
> >> another class of documentation for the console. I think that
> re-purposing
> >> the javadoc is the best approach here and if we write some good javadoc
> we
> >> will roughly cover your categories. You could obviously display the
> text
> >> of the javadoc, which would likely cover your first two categories (if
> >> written well). For the links, we could add @see tags as needed to the
> >> javadoc and those would be the links to display in the console.
> >>
> >>
> >>
> >>
> >>
> >> On Fri, Apr 24, 2015 at 7:13 PM, Christos Oikonomou <
> >> chrikon1994@gmail.com>
> >> wrote:
> >>
> >> > I am glad for your reaction.
> >> > I was thinking that we can display the information in 4 categories
> >> >
> >> > gremlin> :doc foo
> >> > Description of Functionality
> >> > .....
> >> > Some relevant functionalities
> >> > ......
> >> > Link to the user documentation
> >> > ......
> >> > Link to the javadoc
> >> > .........
> >> >
> >> > Do you believe that informations will be clear to all kinds of users
> >> >
> >> > On Sat, Apr 25, 2015 at 12:36 AM, Matt Frantz <
> >> matthew.h.frantz@gmail.com>
> >> > wrote:
> >> >
> >> > > Perhaps there should be a command to import the javadocs for a
> >> particular
> >> > > package or interface, e.g. a DSL interface. The effect would be to
> >> haul
> >> > > the methods into the global doc namespace. By default, we would
> apply
> >> > that
> >> > > to GraphTraversal.
> >> > >
> >> > > gremlin> :doc outE
> >> > > TODO: Write a good javadoc for each GraphTraversal method
> >> > > gremlin> :importdoc TinkerFactory.SocialTraversal
> >> > > gremlin> :doc people
> >> > > TODO: Write a good javadoc for each SocialTraversal method
> >> > >
> >> > > It could be applied to any class or interface. Applying it to a
> >> package
> >> > > would haul the classes and subpackages into the global doc
> namespace.
> >> > >
> >> > > gremlin> :importdoc
> org.apache.tinkerpop.gremlin.tinkergraph.structure
> >> > > gremlin> :doc TinkerHelper
> >> > > gremlin> :doc TinkerHelper.queryVertexIndex
> >> > >
> >> > > Maybe you could allow fully-qualified resolution without an import:
> >> > >
> >> > > gremlin> :doc
> >> > >
> >> > >
> >> >
> >>
> org.apache.tinkerpop.gremlin.tinkergraph.structure.TinkerHelper.queryVertexIndex
> >> > >
> >> > > This seems like something that could be contributed upstream to the
> >> > Groovy
> >> > > REPL.
> >> > >
> >> > > On Fri, Apr 24, 2015 at 12:10 PM, Stephen Mallette <
> >> spmallette@gmail.com
> >> > >
> >> > > wrote:
> >> > >
> >> > > > Yeah - it would be straightforward to bring in javadoc for the
> most
> >> > part:
> >> > > >
> >> > > > gremlin> :doc EdgeVertexStep
> >> > > >
> >> > > > you can get the class from that and full package name with
> >> reflection
> >> > > then
> >> > > > translate it to javadoc to extract some text to display in the
> >> console.
> >> > > I
> >> > > > guess that's nice, but no one knows VertexStep. They know this
> step
> >> > > > though:
> >> > > >
> >> > > > gremlin> :doc outE
> >> > > >
> >> > > > So - I guess the question is how one would go from just a pure
> >> javadoc
> >> > > > lookup command (cool but a bit less useful to a first time user
> who
> >> > > doesn't
> >> > > > know the classes - not that EdgeVertexStep would yield anything
> >> about
> >> > > outE
> >> > > > for that matter as it sits) to something that gives the user
> >> content on
> >> > > > steps from GraphTraversal which is the core of the DSL. And then
> -
> >> how
> >> > > > would it extend to other DSLs so that it was generally applicable
> to
> >> > > those
> >> > > > extending the language.
> >> > > >
> >> > > >
> >> > > >
> >> > > > On Fri, Apr 24, 2015 at 3:02 PM, Marko Rodriguez <
> >> okrammarko@gmail.com
> >> > >
> >> > > > wrote:
> >> > > >
> >> > > > > That would be really classy. It would be cool if that could be
> >> read
> >> > > from
> >> > > > > the JavaDoc somehow………… then we kill two birds with one stone.
> >> > > > >
> >> > > > > Marko.
> >> > > > >
> >> > > > > http://markorodriguez.com
> >> > > > >
> >> > > > > On Apr 24, 2015, at 12:08 PM, Stephen Mallette <
> >> spmallette@gmail.com
> >> > >
> >> > > > > wrote:
> >> > > > >
> >> > > > > >> A gremlin-command that display in gremlin-console user
> >> > documentation
> >> > > > or
> >> > > > > > javadocs of a gremlin functionality could be something that
> >> helps
> >> > > user?
> >> > > > > >
> >> > > > > > That's an interesting idea. I assume you are suggesting
> >> something
> >> > > > like:
> >> > > > > >
> >> > > > > > gremlin> :doc choose
> >> > > > > > ==>The choose()-step (branch) routes the current traverser to
> a
> >> > > > > particular
> >> > > > > > traversal branch option. With choose(), it is possible to
> >> > > > implement......
> >> > > > > >
> >> > > > > > Is that what you mean?
> >> > > > > >
> >> > > > > >
> >> > > > > >
> >> > > > > >
> >> > > > > > On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <
> >> > > > > chrikon1994@gmail.com>
> >> > > > > > wrote:
> >> > > > > >
> >> > > > > >> Hello and sorry for the delay. Thanks for the answers.
> >> > > > > >> I have done a general overview of all the code base. But more
> >> > > > > familiarized
> >> > > > > >> I am in gremlin-core and gremlin-console.
> >> > > > > >> I prefer the assignment of issues because I wants to help
> also
> >> to
> >> > > the
> >> > > > > >> faster achievement of the project planning in general.
> >> > > > > >> Also I have an idea in documentation. A gremlin-command that
> >> > display
> >> > > > in
> >> > > > > >> gremlin-console user documentation or javadocs of a gremlin
> >> > > > > functionality
> >> > > > > >> could be something that helps user?
> >> > > > > >>
> >> > > > > >> Regards,
> >> > > > > >> Christos
> >> > > > > >>
> >> > > > > >> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <
> >> > > > > m.ben.franklin@gmail.com>
> >> > > > > >> wrote:
> >> > > > > >>
> >> > > > > >>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <
> >> > > > okrammarko@gmail.com>
> >> > > > > >>> wrote:
> >> > > > > >>>
> >> > > > > >>>> Hi Christos,
> >> > > > > >>>>
> >> > > > > >>>> Given that you have familiarized yourself with the
> codebase,
> >> > which
> >> > > > > area
> >> > > > > >>> of
> >> > > > > >>>> the codebase do you feel:
> >> > > > > >>>>
> >> > > > > >>>> 1. you understand the best, and
> >> > > > > >>>> 2. are interested in working on.
> >> > > > > >>>>
> >> > > > > >>>> Given that information, I will be able to figure out
> >> something
> >> > > > > >> particular
> >> > > > > >>>> for you to do.
> >> > > > > >>>>
> >> > > > > >>>
> >> > > > > >>> You should also feel free to pick an issue off of JIRA
> >> yourself,
> >> > or
> >> > > > > even
> >> > > > > >>> create an issue and submit a patch for it.
> >> > > > > >>>
> >> > > > > >>>
> >> > > > > >>>>
> >> > > > > >>>> Thanks,
> >> > > > > >>>> Marko.
> >> > > > > >>>>
> >> > > > > >>>> http://markorodriguez.com
> >> > > > > >>>>
> >> > > > > >>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
> >> > > > > >> chrikon1994@gmail.com>
> >> > > > > >>>> wrote:
> >> > > > > >>>>
> >> > > > > >>>>> Hello everyone,
> >> > > > > >>>>>
> >> > > > > >>>>> I have read your advices how to start and how to be
> >> > familiarized
> >> > > > with
> >> > > > > >>> the
> >> > > > > >>>>> codebase. After some time I spent exploring the code, I
> >> > believe I
> >> > > > am
> >> > > > > >>>> ready
> >> > > > > >>>>> to start specific changes in the code.
> >> > > > > >>>>>
> >> > > > > >>>>> So am sending this message to ask you, if some of you have
> >> > ideas
> >> > > > > >> about
> >> > > > > >>>>> features or improvement and you want one more for help.
> >> > > > > >>>>>
> >> > > > > >>>>> Also if you have some issues you want some help please let
> >> me
> >> > > know
> >> > > > > >>> (jira
> >> > > > > >>>>> account chrikon).
> >> > > > > >>>>>
> >> > > > > >>>>> Thanks in advance,
> >> > > > > >>>>>
> >> > > > > >>>>> Regards
> >> > > > > >>>>> Christos
> >> > > > > >>>>>
> >> > > > > >>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <
> >> > > > > >>>> chrikon1994@gmail.com>
> >> > > > > >>>>> wrote:
> >> > > > > >>>>>
> >> > > > > >>>>>> Sorry Hadrian thank you for your correction, this will
> not
> >> > > happen
> >> > > > > >>> again!
> >> > > > > >>>>>>
> >> > > > > >>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <
> >> > > > > >> hzbarcea@gmail.com>
> >> > > > > >>>>>> wrote:
> >> > > > > >>>>>>
> >> > > > > >>>>>>> Hi Christos,
> >> > > > > >>>>>>>
> >> > > > > >>>>>>> First off, I am not a Mister :), just Hadrian.
> >> > > > > >>>>>>>
> >> > > > > >>>>>>> Yes, the idea is to collaborate, that's what open source
> >> is
> >> > > > about.
> >> > > > > >>>>>>>
> >> > > > > >>>>>>> Good luck,
> >> > > > > >>>>>>> Hadrian
> >> > > > > >>>>>>>
> >> > > > > >>>>>>>
> >> > > > > >>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
> >> > > > > >>>>>>>
> >> > > > > >>>>>>>> Firstly thank you all for your suggestions, all of them
> >> are
> >> > > very
> >> > > > > >>>> helpful.
> >> > > > > >>>>>>>>
> >> > > > > >>>>>>>> In this moment I follow the very good advice and I am
> >> > reading
> >> > > > > >>>>>>>> documentation, because next Wednesday I have to make a
> >> > > > > >> presentation
> >> > > > > >>>> for
> >> > > > > >>>>>>>> tinkerpop in front of my class!
> >> > > > > >>>>>>>>
> >> > > > > >>>>>>>> Marko I have to write code for my assignment, but in my
> >> free
> >> > > > time
> >> > > > > >> it
> >> > > > > >>>> is
> >> > > > > >>>>>>>> an
> >> > > > > >>>>>>>> interesting work.
> >> > > > > >>>>>>>>
> >> > > > > >>>>>>>> Although Javadoc it is applicable to my assignment, I
> >> > think. I
> >> > > > > >> will
> >> > > > > >>>> ask
> >> > > > > >>>>>>>> and
> >> > > > > >>>>>>>> I will have news.
> >> > > > > >>>>>>>>
> >> > > > > >>>>>>>> If Mr. Hadrian Zbarcea are working on it, I would like
> >> not
> >> > to
> >> > > > > >>>> interfere
> >> > > > > >>>>>>>> in
> >> > > > > >>>>>>>> your job, or we can cooperate.
> >> > > > > >>>>>>>> Before that discussion I have to contact to my academic
> >> > > > supervisor
> >> > > > > >>> in
> >> > > > > >>>>>>>> order
> >> > > > > >>>>>>>> to be 100% sure that this is ok.
> >> > > > > >>>>>>>>
> >> > > > > >>>>>>>> P.S. I hope my English is at least understandable, if
> >> not so
> >> > > > > >> please
> >> > > > > >>>> ask
> >> > > > > >>>>>>>> me
> >> > > > > >>>>>>>> again.
> >> > > > > >>>>>>>>
> >> > > > > >>>>>>>> Thank you all.
> >> > > > > >>>>>>>> Christos
> >> > > > > >>>>>>>>
> >> > > > > >>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <
> >> > > > > >>> hzbarcea@gmail.com>
> >> > > > > >>>>>>>> wrote:
> >> > > > > >>>>>>>>
> >> > > > > >>>>>>>> That's something I am interested in too.
> >> > > > > >>>>>>>>> Hadrian
> >> > > > > >>>>>>>>>
> >> > > > > >>>>>>>>>
> >> > > > > >>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
> >> > > > > >>>>>>>>>
> >> > > > > >>>>>>>>> Hi Christos,
> >> > > > > >>>>>>>>>>
> >> > > > > >>>>>>>>>> Another thing that we need is more JavaDoc! Its not
> >> sexy,
> >> > > but
> >> > > > > >> boy
> >> > > > > >>>> would
> >> > > > > >>>>>>>>>> be it be great to have someone go through and
> >> JavaDoc-up
> >> > > > > >>>> GraphTraversal
> >> > > > > >>>>>>>>>> (all those methods…).
> >> > > > > >>>>>>>>>>
> >> > > > > >>>>>>>>>>
> >> > https://github.com/apache/incubator-tinkerpop/blob/
> >> > > > > >>>>>>>>>>
> master/gremlin-core/src/main/java/org/apache/tinkerpop/
> >> > > > > >>>>>>>>>>
> gremlin/process/traversal/dsl/graph/GraphTraversal.java
> >> > > > > >>>>>>>>>>
> >> > > > > >>>>>>>>>> …the docs provide a description of each step.
> >> > > > > >>>>>>>>>>
> >> > > > > >>>>>>>>>>
> >> http://tinkerpop.incubator.apache.org/docs/3.0.0-
> >> > > > > >>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct clicking
> to
> >> > any
> >> > > > > >>>> particular
> >> > > > > >>>>>>>>>> step)
> >> > > > > >>>>>>>>>>
> >> > > > > >>>>>>>>>> I would say that would be more helpful now than a
> >> "Through
> >> > > the
> >> > > > > >>>>>>>>>> TinkerPop"-tutorial.
> >> > > > > >>>>>>>>>>
> >> > > > > >>>>>>>>>> Finally, what else would be helpful --- more test
> >> cases.
> >> > If
> >> > > > you
> >> > > > > >>> are
> >> > > > > >>>>>>>>>> interested in testing, I can get your set up in with
> "a
> >> > > > pattern"
> >> > > > > >>> so
> >> > > > > >>>>>>>>>> you pop
> >> > > > > >>>>>>>>>> out more process/ tests. For example:
> >> > > > > >>>>>>>>>>
> >> > > > > >>>>>>>>>>
> >> > https://github.com/apache/incubator-tinkerpop/blob/
> >> > > > > >>>>>>>>>>
> master/gremlin-test/src/main/java/org/apache/tinkerpop/
> >> > > > > >>>>>>>>>> gremlin/process/traversal/step/map/CountTest.java
> >> > > > > >>>>>>>>>>
> >> > > > > >>>>>>>>>> Thanks,
> >> > > > > >>>>>>>>>> Marko.
> >> > > > > >>>>>>>>>>
> >> > > > > >>>>>>>>>> http://markorodriguez.com
> >> > > > > >>>>>>>>>>
> >> > > > > >>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <
> >> > > > > >>> okrammarko@gmail.com>
> >> > > > > >>>>>>>>>> wrote:
> >> > > > > >>>>>>>>>>
> >> > > > > >>>>>>>>>> Hi Christos,
> >> > > > > >>>>>>>>>>
> >> > > > > >>>>>>>>>>>
> >> > > > > >>>>>>>>>>> Are you interested in writing code or perhaps,
> >> writing a
> >> > > > > >>> tutorial?
> >> > > > > >>>>>>>>>>>
> >> > > > > >>>>>>>>>>> It would be nice to have an in-depth tutorial on
> >> > > TinkerPop3.
> >> > > > > >> For
> >> > > > > >>>>>>>>>>> instance, find a reasonably sized dataset (<1
> million
> >> > > edges),
> >> > > > > >>> parse
> >> > > > > >>>>>>>>>>> it into
> >> > > > > >>>>>>>>>>> a graph, do some analysis on it, expose it via
> Gremlin
> >> > > > Server,
> >> > > > > >>> OLTP
> >> > > > > >>>>>>>>>>> and
> >> > > > > >>>>>>>>>>> OLAP queries hitting it, etc. Write up the path you
> >> took
> >> > > into
> >> > > > > >> an
> >> > > > > >>>>>>>>>>> AsciiDoc
> >> > > > > >>>>>>>>>>> and we could put it on the Apache TinkerPop site as
> a
> >> > > > "Through
> >> > > > > >>> the
> >> > > > > >>>>>>>>>>> TinkerPop" tutorial. Be great if you could touch on
> >> every
> >> > > > > >> aspect
> >> > > > > >>> of
> >> > > > > >>>>>>>>>>> the
> >> > > > > >>>>>>>>>>> TinkerPop framework in the tutorial.
> >> > > > > >>>>>>>>>>>
> >> > > > > >>>>>>>>>>> I would appreciate a contribution like that.
> >> > > > > >>>>>>>>>>>
> >> > > > > >>>>>>>>>>> Thanks,
> >> > > > > >>>>>>>>>>> Marko.
> >> > > > > >>>>>>>>>>>
> >> > > > > >>>>>>>>>>> http://markorodriguez.com
> >> > > > > >>>>>>>>>>>
> >> > > > > >>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
> >> > > > > >>>> m.ben.franklin@gmail.com>
> >> > > > > >>>>>>>>>>> wrote:
> >> > > > > >>>>>>>>>>>
> >> > > > > >>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen Mallette <
> >> > > > > >>>>>>>>>>> spmallette@gmail.com>
> >> > > > > >>>>>>>>>>>
> >> > > > > >>>>>>>>>>>> wrote:
> >> > > > > >>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>> My suggestion would be for you to spend some time
> >> > learning
> >> > > > > >>> about
> >> > > > > >>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>> TinkerPop
> >> > > > > >>>>>>>>>>>>> (reading the documentation, examining the code
> base,
> >> > > > perusing
> >> > > > > >>> the
> >> > > > > >>>>>>>>>>>>> Jira
> >> > > > > >>>>>>>>>>>>> issue tracker, etc.) to determine if any
> particular
> >> > part
> >> > > of
> >> > > > > >> the
> >> > > > > >>>>>>>>>>>>> stack
> >> > > > > >>>>>>>>>>>>> interests you.
> >> > > > > >>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>> IMO, there is no better way to get involved than to
> >> pick
> >> > > > > >>> something
> >> > > > > >>>>>>>>>>>> that
> >> > > > > >>>>>>>>>>>> needs to be worked on and provide a patch for it.
> I
> >> > would
> >> > > > > >> look
> >> > > > > >>> at
> >> > > > > >>>>>>>>>>>> JIRA
> >> > > > > >>>>>>>>>>>> and
> >> > > > > >>>>>>>>>>>> find an issue that interests you.
> >> > > > > >>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>> In doing that, you might develop your own ideas as
> to
> >> > > > > >>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>> where/what you think you are best suited to
> >> contribute.
> >> > > At
> >> > > > > >>> that
> >> > > > > >>>>>>>>>>>>> point
> >> > > > > >>>>>>>>>>>>> you
> >> > > > > >>>>>>>>>>>>> could post those ideas here in the mailing list
> for
> >> > > > feedback.
> >> > > > > >>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos
> Oikonomou
> >> <
> >> > > > > >>>>>>>>>>>>> chrikon1994@gmail.com
> >> > > > > >>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>> wrote:
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>> Hi Stephen
> >> > > > > >>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>> When I start I was not familiar with the project
> >> nor
> >> > the
> >> > > > > >>>>>>>>>>>>>> architecture/codebase.
> >> > > > > >>>>>>>>>>>>>> But I am reading about tinkerpop and searching in
> >> the
> >> > > code
> >> > > > > >> and
> >> > > > > >>>>>>>>>>>>>> I am thinking to make some simple examples in
> >> order to
> >> > > be
> >> > > > > >> more
> >> > > > > >>>>>>>>>>>>>> familiar
> >> > > > > >>>>>>>>>>>>>> with the functionality.
> >> > > > > >>>>>>>>>>>>>> So I am not now very familiar but I try to be in
> >> the
> >> > > near
> >> > > > > >>>> future.
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>> Christos
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen
> Mallette <
> >> > > > > >>>>>>>>>>>>>> spmallette@gmail.com>
> >> > > > > >>>>>>>>>>>>>> wrote:
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>> Hi Christos, we appreciate your offer to
> >> contribute.
> >> > > > Could
> >> > > > > >>> you
> >> > > > > >>>>>>>>>>>>>> tell
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>> us
> >> > > > > >>>>>>>>>>>>>>> what kind of experience you have with TinkerPop
> so
> >> > far?
> >> > > > > >> Are
> >> > > > > >>>> you
> >> > > > > >>>>>>>>>>>>>>> at
> >> > > > > >>>>>>>>>>>>>>> all
> >> > > > > >>>>>>>>>>>>>>> familiar with the architecture/codebase?
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>> Stephen
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos
> >> Oikonomou
> >> > <
> >> > > > > >>>>>>>>>>>>>>> chrikon1994@gmail.com>
> >> > > > > >>>>>>>>>>>>>>> wrote:
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>> Dear Tinkerpop Development Team
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>> My name is Christos Economou.
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>> I would like to contribute in the tinkerpop3.
> >> > > > > >>>>>>>>>>>>>>>> This contribution will be a part of an
> >> assignment in
> >> > > one
> >> > > > > >> of
> >> > > > > >>> my
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>> classes.
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>> I am in my third year of study at Athens
> >> University of
> >> > > > > >>> Economics
> >> > > > > >>>>>>>>>>>>>>>> and
> >> > > > > >>>>>>>>>>>>>>>> Business (Greece | Hellas).In this semester I
> >> attend
> >> > > in
> >> > > > > >>>> lectures
> >> > > > > >>>>>>>>>>>>>>>> that
> >> > > > > >>>>>>>>>>>>>>>> called "Advanced Topics in Software
> Engineering"
> >> by
> >> > > > > >>> professor
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>> Diomidis
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>> Spinellis.
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>> As assignment I have to contribute in an open
> >> source
> >> > > > > >>> project.
> >> > > > > >>>> I
> >> > > > > >>>>>>>>>>>>>>>> would
> >> > > > > >>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3. More
> >> > specifically
> >> > > I
> >> > > > > >>>>>>>>>>>>>>>> understand
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>> that
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>> in
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>> big projects, like this, always exists work on
> >> > > > integration
> >> > > > > >>> and
> >> > > > > >>>>>>>>>>>>>>>> collaboration between components and
> subsystems.
> >> So
> >> > I
> >> > > do
> >> > > > > >> not
> >> > > > > >>>> have
> >> > > > > >>>>>>>>>>>>>>>> any
> >> > > > > >>>>>>>>>>>>>>>> problem to work on that. But I am more
> >> interested in
> >> > > > > >>> creative
> >> > > > > >>>>>>>>>>>>>>>> work
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>> like
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>> implementation of some algorithm or on a new
> >> > > functionality.
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>> I have to mention I have a hard constraint,
> that
> >> my
> >> > > > > >>>> contribution
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>> should
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>> be
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>> at least 100 - 200 lines of code.
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>> So I am writing you to ask if you have in mind
> >> some
> >> > > > > >>>>>>>>>>>>>>>> functionalities
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>> that
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>> I
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>> can help in development. Here some information
> >> about
> >> > my
> >> > > > > >>>>>>>>>>>>>>>> knowledge in
> >> > > > > >>>>>>>>>>>>>>>> software engineering and programming languages
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>> inetpub/detfolio/.
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>> Thank you for your time and attention.
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>> Regards,
> >> > > > > >>>>>>>>>>>>>>>> Christos Oikonomou
> >> > > > > >>>>>>>>>>>>>>>> Assistant researcher at ISTLab
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
> >> > > > > >>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>>>
> >> > > > > >>>>>>>>>>>
> >> > > > > >>>>>>>>>>
> >> > > > > >>>>>>>>>>
> >> > > > > >>>>>>>>
> >> > > > > >>>>>>
> >> > > > > >>>>
> >> > > > > >>>>
> >> > > > > >>>
> >> > > > > >>
> >> > > > >
> >> > > > >
> >> > > >
> >> > >
> >> >
> >>
> >
> >
>
Re: Contributing to tinkerpop3
Posted by Christos Oikonomou <ch...@gmail.com>.
Hello everyone
I was working on Java displaying in gremlin console.
I have came to a point that I need your guidance.
I have made 3 classes one for importing, for Doc structure in a class and
third for the structure of the data in a method.
Also I add 2 commands in groovy the ImportDocsCommand and DicsCommand. The
first impliment the import of the javadocs of a class for the Class.html
and the second the displaying.
Firstly what are your thoughts for those,
Secondly what is the correct path for the javadoc in release and in
development version?
Regards
Christos
On Sat, Apr 25, 2015 at 2:59 PM, Christos Oikonomou <ch...@gmail.com>
wrote:
> I thought we can create an doc.xml with all the relative information
> gathered for every function.
>
> Although I see your point.
>
> But I like also the idea of Matt.....
>
> As I see this was something that interest you so I will start working on
> how that should be implemented.
>
> Regards,
> Christos
>
> On Sat, Apr 25, 2015 at 1:35 PM, Stephen Mallette <sp...@gmail.com>
> wrote:
>
>> Matt, I like idea for a :docimport command. By default we would load
>> GraphTraversal into it so that
>>
>> gremlin> :doc outE
>>
>> could resolve to the appropriate javadoc right out the box. It is
>> generally applicable and as you say might even be of interest to the
>> groovy
>> project at some point.
>>
>> Christos, I think the categories you mention are good, but I would take
>> care to consider the source of the documentation. Where would those
>> categories come from for you to display them? I don't think it would be
>> especially helpful if we had to manage javadoc, the asciidoc and then
>> another class of documentation for the console. I think that re-purposing
>> the javadoc is the best approach here and if we write some good javadoc we
>> will roughly cover your categories. You could obviously display the text
>> of the javadoc, which would likely cover your first two categories (if
>> written well). For the links, we could add @see tags as needed to the
>> javadoc and those would be the links to display in the console.
>>
>>
>>
>>
>>
>> On Fri, Apr 24, 2015 at 7:13 PM, Christos Oikonomou <
>> chrikon1994@gmail.com>
>> wrote:
>>
>> > I am glad for your reaction.
>> > I was thinking that we can display the information in 4 categories
>> >
>> > gremlin> :doc foo
>> > Description of Functionality
>> > .....
>> > Some relevant functionalities
>> > ......
>> > Link to the user documentation
>> > ......
>> > Link to the javadoc
>> > .........
>> >
>> > Do you believe that informations will be clear to all kinds of users
>> >
>> > On Sat, Apr 25, 2015 at 12:36 AM, Matt Frantz <
>> matthew.h.frantz@gmail.com>
>> > wrote:
>> >
>> > > Perhaps there should be a command to import the javadocs for a
>> particular
>> > > package or interface, e.g. a DSL interface. The effect would be to
>> haul
>> > > the methods into the global doc namespace. By default, we would apply
>> > that
>> > > to GraphTraversal.
>> > >
>> > > gremlin> :doc outE
>> > > TODO: Write a good javadoc for each GraphTraversal method
>> > > gremlin> :importdoc TinkerFactory.SocialTraversal
>> > > gremlin> :doc people
>> > > TODO: Write a good javadoc for each SocialTraversal method
>> > >
>> > > It could be applied to any class or interface. Applying it to a
>> package
>> > > would haul the classes and subpackages into the global doc namespace.
>> > >
>> > > gremlin> :importdoc org.apache.tinkerpop.gremlin.tinkergraph.structure
>> > > gremlin> :doc TinkerHelper
>> > > gremlin> :doc TinkerHelper.queryVertexIndex
>> > >
>> > > Maybe you could allow fully-qualified resolution without an import:
>> > >
>> > > gremlin> :doc
>> > >
>> > >
>> >
>> org.apache.tinkerpop.gremlin.tinkergraph.structure.TinkerHelper.queryVertexIndex
>> > >
>> > > This seems like something that could be contributed upstream to the
>> > Groovy
>> > > REPL.
>> > >
>> > > On Fri, Apr 24, 2015 at 12:10 PM, Stephen Mallette <
>> spmallette@gmail.com
>> > >
>> > > wrote:
>> > >
>> > > > Yeah - it would be straightforward to bring in javadoc for the most
>> > part:
>> > > >
>> > > > gremlin> :doc EdgeVertexStep
>> > > >
>> > > > you can get the class from that and full package name with
>> reflection
>> > > then
>> > > > translate it to javadoc to extract some text to display in the
>> console.
>> > > I
>> > > > guess that's nice, but no one knows VertexStep. They know this step
>> > > > though:
>> > > >
>> > > > gremlin> :doc outE
>> > > >
>> > > > So - I guess the question is how one would go from just a pure
>> javadoc
>> > > > lookup command (cool but a bit less useful to a first time user who
>> > > doesn't
>> > > > know the classes - not that EdgeVertexStep would yield anything
>> about
>> > > outE
>> > > > for that matter as it sits) to something that gives the user
>> content on
>> > > > steps from GraphTraversal which is the core of the DSL. And then -
>> how
>> > > > would it extend to other DSLs so that it was generally applicable to
>> > > those
>> > > > extending the language.
>> > > >
>> > > >
>> > > >
>> > > > On Fri, Apr 24, 2015 at 3:02 PM, Marko Rodriguez <
>> okrammarko@gmail.com
>> > >
>> > > > wrote:
>> > > >
>> > > > > That would be really classy. It would be cool if that could be
>> read
>> > > from
>> > > > > the JavaDoc somehow………… then we kill two birds with one stone.
>> > > > >
>> > > > > Marko.
>> > > > >
>> > > > > http://markorodriguez.com
>> > > > >
>> > > > > On Apr 24, 2015, at 12:08 PM, Stephen Mallette <
>> spmallette@gmail.com
>> > >
>> > > > > wrote:
>> > > > >
>> > > > > >> A gremlin-command that display in gremlin-console user
>> > documentation
>> > > > or
>> > > > > > javadocs of a gremlin functionality could be something that
>> helps
>> > > user?
>> > > > > >
>> > > > > > That's an interesting idea. I assume you are suggesting
>> something
>> > > > like:
>> > > > > >
>> > > > > > gremlin> :doc choose
>> > > > > > ==>The choose()-step (branch) routes the current traverser to a
>> > > > > particular
>> > > > > > traversal branch option. With choose(), it is possible to
>> > > > implement......
>> > > > > >
>> > > > > > Is that what you mean?
>> > > > > >
>> > > > > >
>> > > > > >
>> > > > > >
>> > > > > > On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <
>> > > > > chrikon1994@gmail.com>
>> > > > > > wrote:
>> > > > > >
>> > > > > >> Hello and sorry for the delay. Thanks for the answers.
>> > > > > >> I have done a general overview of all the code base. But more
>> > > > > familiarized
>> > > > > >> I am in gremlin-core and gremlin-console.
>> > > > > >> I prefer the assignment of issues because I wants to help also
>> to
>> > > the
>> > > > > >> faster achievement of the project planning in general.
>> > > > > >> Also I have an idea in documentation. A gremlin-command that
>> > display
>> > > > in
>> > > > > >> gremlin-console user documentation or javadocs of a gremlin
>> > > > > functionality
>> > > > > >> could be something that helps user?
>> > > > > >>
>> > > > > >> Regards,
>> > > > > >> Christos
>> > > > > >>
>> > > > > >> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <
>> > > > > m.ben.franklin@gmail.com>
>> > > > > >> wrote:
>> > > > > >>
>> > > > > >>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <
>> > > > okrammarko@gmail.com>
>> > > > > >>> wrote:
>> > > > > >>>
>> > > > > >>>> Hi Christos,
>> > > > > >>>>
>> > > > > >>>> Given that you have familiarized yourself with the codebase,
>> > which
>> > > > > area
>> > > > > >>> of
>> > > > > >>>> the codebase do you feel:
>> > > > > >>>>
>> > > > > >>>> 1. you understand the best, and
>> > > > > >>>> 2. are interested in working on.
>> > > > > >>>>
>> > > > > >>>> Given that information, I will be able to figure out
>> something
>> > > > > >> particular
>> > > > > >>>> for you to do.
>> > > > > >>>>
>> > > > > >>>
>> > > > > >>> You should also feel free to pick an issue off of JIRA
>> yourself,
>> > or
>> > > > > even
>> > > > > >>> create an issue and submit a patch for it.
>> > > > > >>>
>> > > > > >>>
>> > > > > >>>>
>> > > > > >>>> Thanks,
>> > > > > >>>> Marko.
>> > > > > >>>>
>> > > > > >>>> http://markorodriguez.com
>> > > > > >>>>
>> > > > > >>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
>> > > > > >> chrikon1994@gmail.com>
>> > > > > >>>> wrote:
>> > > > > >>>>
>> > > > > >>>>> Hello everyone,
>> > > > > >>>>>
>> > > > > >>>>> I have read your advices how to start and how to be
>> > familiarized
>> > > > with
>> > > > > >>> the
>> > > > > >>>>> codebase. After some time I spent exploring the code, I
>> > believe I
>> > > > am
>> > > > > >>>> ready
>> > > > > >>>>> to start specific changes in the code.
>> > > > > >>>>>
>> > > > > >>>>> So am sending this message to ask you, if some of you have
>> > ideas
>> > > > > >> about
>> > > > > >>>>> features or improvement and you want one more for help.
>> > > > > >>>>>
>> > > > > >>>>> Also if you have some issues you want some help please let
>> me
>> > > know
>> > > > > >>> (jira
>> > > > > >>>>> account chrikon).
>> > > > > >>>>>
>> > > > > >>>>> Thanks in advance,
>> > > > > >>>>>
>> > > > > >>>>> Regards
>> > > > > >>>>> Christos
>> > > > > >>>>>
>> > > > > >>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <
>> > > > > >>>> chrikon1994@gmail.com>
>> > > > > >>>>> wrote:
>> > > > > >>>>>
>> > > > > >>>>>> Sorry Hadrian thank you for your correction, this will not
>> > > happen
>> > > > > >>> again!
>> > > > > >>>>>>
>> > > > > >>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <
>> > > > > >> hzbarcea@gmail.com>
>> > > > > >>>>>> wrote:
>> > > > > >>>>>>
>> > > > > >>>>>>> Hi Christos,
>> > > > > >>>>>>>
>> > > > > >>>>>>> First off, I am not a Mister :), just Hadrian.
>> > > > > >>>>>>>
>> > > > > >>>>>>> Yes, the idea is to collaborate, that's what open source
>> is
>> > > > about.
>> > > > > >>>>>>>
>> > > > > >>>>>>> Good luck,
>> > > > > >>>>>>> Hadrian
>> > > > > >>>>>>>
>> > > > > >>>>>>>
>> > > > > >>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
>> > > > > >>>>>>>
>> > > > > >>>>>>>> Firstly thank you all for your suggestions, all of them
>> are
>> > > very
>> > > > > >>>> helpful.
>> > > > > >>>>>>>>
>> > > > > >>>>>>>> In this moment I follow the very good advice and I am
>> > reading
>> > > > > >>>>>>>> documentation, because next Wednesday I have to make a
>> > > > > >> presentation
>> > > > > >>>> for
>> > > > > >>>>>>>> tinkerpop in front of my class!
>> > > > > >>>>>>>>
>> > > > > >>>>>>>> Marko I have to write code for my assignment, but in my
>> free
>> > > > time
>> > > > > >> it
>> > > > > >>>> is
>> > > > > >>>>>>>> an
>> > > > > >>>>>>>> interesting work.
>> > > > > >>>>>>>>
>> > > > > >>>>>>>> Although Javadoc it is applicable to my assignment, I
>> > think. I
>> > > > > >> will
>> > > > > >>>> ask
>> > > > > >>>>>>>> and
>> > > > > >>>>>>>> I will have news.
>> > > > > >>>>>>>>
>> > > > > >>>>>>>> If Mr. Hadrian Zbarcea are working on it, I would like
>> not
>> > to
>> > > > > >>>> interfere
>> > > > > >>>>>>>> in
>> > > > > >>>>>>>> your job, or we can cooperate.
>> > > > > >>>>>>>> Before that discussion I have to contact to my academic
>> > > > supervisor
>> > > > > >>> in
>> > > > > >>>>>>>> order
>> > > > > >>>>>>>> to be 100% sure that this is ok.
>> > > > > >>>>>>>>
>> > > > > >>>>>>>> P.S. I hope my English is at least understandable, if
>> not so
>> > > > > >> please
>> > > > > >>>> ask
>> > > > > >>>>>>>> me
>> > > > > >>>>>>>> again.
>> > > > > >>>>>>>>
>> > > > > >>>>>>>> Thank you all.
>> > > > > >>>>>>>> Christos
>> > > > > >>>>>>>>
>> > > > > >>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <
>> > > > > >>> hzbarcea@gmail.com>
>> > > > > >>>>>>>> wrote:
>> > > > > >>>>>>>>
>> > > > > >>>>>>>> That's something I am interested in too.
>> > > > > >>>>>>>>> Hadrian
>> > > > > >>>>>>>>>
>> > > > > >>>>>>>>>
>> > > > > >>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
>> > > > > >>>>>>>>>
>> > > > > >>>>>>>>> Hi Christos,
>> > > > > >>>>>>>>>>
>> > > > > >>>>>>>>>> Another thing that we need is more JavaDoc! Its not
>> sexy,
>> > > but
>> > > > > >> boy
>> > > > > >>>> would
>> > > > > >>>>>>>>>> be it be great to have someone go through and
>> JavaDoc-up
>> > > > > >>>> GraphTraversal
>> > > > > >>>>>>>>>> (all those methods…).
>> > > > > >>>>>>>>>>
>> > > > > >>>>>>>>>>
>> > https://github.com/apache/incubator-tinkerpop/blob/
>> > > > > >>>>>>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
>> > > > > >>>>>>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
>> > > > > >>>>>>>>>>
>> > > > > >>>>>>>>>> …the docs provide a description of each step.
>> > > > > >>>>>>>>>>
>> > > > > >>>>>>>>>>
>> http://tinkerpop.incubator.apache.org/docs/3.0.0-
>> > > > > >>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct clicking to
>> > any
>> > > > > >>>> particular
>> > > > > >>>>>>>>>> step)
>> > > > > >>>>>>>>>>
>> > > > > >>>>>>>>>> I would say that would be more helpful now than a
>> "Through
>> > > the
>> > > > > >>>>>>>>>> TinkerPop"-tutorial.
>> > > > > >>>>>>>>>>
>> > > > > >>>>>>>>>> Finally, what else would be helpful --- more test
>> cases.
>> > If
>> > > > you
>> > > > > >>> are
>> > > > > >>>>>>>>>> interested in testing, I can get your set up in with "a
>> > > > pattern"
>> > > > > >>> so
>> > > > > >>>>>>>>>> you pop
>> > > > > >>>>>>>>>> out more process/ tests. For example:
>> > > > > >>>>>>>>>>
>> > > > > >>>>>>>>>>
>> > https://github.com/apache/incubator-tinkerpop/blob/
>> > > > > >>>>>>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
>> > > > > >>>>>>>>>> gremlin/process/traversal/step/map/CountTest.java
>> > > > > >>>>>>>>>>
>> > > > > >>>>>>>>>> Thanks,
>> > > > > >>>>>>>>>> Marko.
>> > > > > >>>>>>>>>>
>> > > > > >>>>>>>>>> http://markorodriguez.com
>> > > > > >>>>>>>>>>
>> > > > > >>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <
>> > > > > >>> okrammarko@gmail.com>
>> > > > > >>>>>>>>>> wrote:
>> > > > > >>>>>>>>>>
>> > > > > >>>>>>>>>> Hi Christos,
>> > > > > >>>>>>>>>>
>> > > > > >>>>>>>>>>>
>> > > > > >>>>>>>>>>> Are you interested in writing code or perhaps,
>> writing a
>> > > > > >>> tutorial?
>> > > > > >>>>>>>>>>>
>> > > > > >>>>>>>>>>> It would be nice to have an in-depth tutorial on
>> > > TinkerPop3.
>> > > > > >> For
>> > > > > >>>>>>>>>>> instance, find a reasonably sized dataset (<1 million
>> > > edges),
>> > > > > >>> parse
>> > > > > >>>>>>>>>>> it into
>> > > > > >>>>>>>>>>> a graph, do some analysis on it, expose it via Gremlin
>> > > > Server,
>> > > > > >>> OLTP
>> > > > > >>>>>>>>>>> and
>> > > > > >>>>>>>>>>> OLAP queries hitting it, etc. Write up the path you
>> took
>> > > into
>> > > > > >> an
>> > > > > >>>>>>>>>>> AsciiDoc
>> > > > > >>>>>>>>>>> and we could put it on the Apache TinkerPop site as a
>> > > > "Through
>> > > > > >>> the
>> > > > > >>>>>>>>>>> TinkerPop" tutorial. Be great if you could touch on
>> every
>> > > > > >> aspect
>> > > > > >>> of
>> > > > > >>>>>>>>>>> the
>> > > > > >>>>>>>>>>> TinkerPop framework in the tutorial.
>> > > > > >>>>>>>>>>>
>> > > > > >>>>>>>>>>> I would appreciate a contribution like that.
>> > > > > >>>>>>>>>>>
>> > > > > >>>>>>>>>>> Thanks,
>> > > > > >>>>>>>>>>> Marko.
>> > > > > >>>>>>>>>>>
>> > > > > >>>>>>>>>>> http://markorodriguez.com
>> > > > > >>>>>>>>>>>
>> > > > > >>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
>> > > > > >>>> m.ben.franklin@gmail.com>
>> > > > > >>>>>>>>>>> wrote:
>> > > > > >>>>>>>>>>>
>> > > > > >>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen Mallette <
>> > > > > >>>>>>>>>>> spmallette@gmail.com>
>> > > > > >>>>>>>>>>>
>> > > > > >>>>>>>>>>>> wrote:
>> > > > > >>>>>>>>>>>>
>> > > > > >>>>>>>>>>>> My suggestion would be for you to spend some time
>> > learning
>> > > > > >>> about
>> > > > > >>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>> TinkerPop
>> > > > > >>>>>>>>>>>>> (reading the documentation, examining the code base,
>> > > > perusing
>> > > > > >>> the
>> > > > > >>>>>>>>>>>>> Jira
>> > > > > >>>>>>>>>>>>> issue tracker, etc.) to determine if any particular
>> > part
>> > > of
>> > > > > >> the
>> > > > > >>>>>>>>>>>>> stack
>> > > > > >>>>>>>>>>>>> interests you.
>> > > > > >>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>
>> > > > > >>>>>>>>>>>> IMO, there is no better way to get involved than to
>> pick
>> > > > > >>> something
>> > > > > >>>>>>>>>>>> that
>> > > > > >>>>>>>>>>>> needs to be worked on and provide a patch for it. I
>> > would
>> > > > > >> look
>> > > > > >>> at
>> > > > > >>>>>>>>>>>> JIRA
>> > > > > >>>>>>>>>>>> and
>> > > > > >>>>>>>>>>>> find an issue that interests you.
>> > > > > >>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>
>> > > > > >>>>>>>>>>>> In doing that, you might develop your own ideas as to
>> > > > > >>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>> where/what you think you are best suited to
>> contribute.
>> > > At
>> > > > > >>> that
>> > > > > >>>>>>>>>>>>> point
>> > > > > >>>>>>>>>>>>> you
>> > > > > >>>>>>>>>>>>> could post those ideas here in the mailing list for
>> > > > feedback.
>> > > > > >>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos Oikonomou
>> <
>> > > > > >>>>>>>>>>>>> chrikon1994@gmail.com
>> > > > > >>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>> wrote:
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>> Hi Stephen
>> > > > > >>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>> When I start I was not familiar with the project
>> nor
>> > the
>> > > > > >>>>>>>>>>>>>> architecture/codebase.
>> > > > > >>>>>>>>>>>>>> But I am reading about tinkerpop and searching in
>> the
>> > > code
>> > > > > >> and
>> > > > > >>>>>>>>>>>>>> I am thinking to make some simple examples in
>> order to
>> > > be
>> > > > > >> more
>> > > > > >>>>>>>>>>>>>> familiar
>> > > > > >>>>>>>>>>>>>> with the functionality.
>> > > > > >>>>>>>>>>>>>> So I am not now very familiar but I try to be in
>> the
>> > > near
>> > > > > >>>> future.
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>> Christos
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen Mallette <
>> > > > > >>>>>>>>>>>>>> spmallette@gmail.com>
>> > > > > >>>>>>>>>>>>>> wrote:
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>> Hi Christos, we appreciate your offer to
>> contribute.
>> > > > Could
>> > > > > >>> you
>> > > > > >>>>>>>>>>>>>> tell
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>> us
>> > > > > >>>>>>>>>>>>>>> what kind of experience you have with TinkerPop so
>> > far?
>> > > > > >> Are
>> > > > > >>>> you
>> > > > > >>>>>>>>>>>>>>> at
>> > > > > >>>>>>>>>>>>>>> all
>> > > > > >>>>>>>>>>>>>>> familiar with the architecture/codebase?
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>> Stephen
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos
>> Oikonomou
>> > <
>> > > > > >>>>>>>>>>>>>>> chrikon1994@gmail.com>
>> > > > > >>>>>>>>>>>>>>> wrote:
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>> Dear Tinkerpop Development Team
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>> My name is Christos Economou.
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>> I would like to contribute in the tinkerpop3.
>> > > > > >>>>>>>>>>>>>>>> This contribution will be a part of an
>> assignment in
>> > > one
>> > > > > >> of
>> > > > > >>> my
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>> classes.
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>> I am in my third year of study at Athens
>> University of
>> > > > > >>> Economics
>> > > > > >>>>>>>>>>>>>>>> and
>> > > > > >>>>>>>>>>>>>>>> Business (Greece | Hellas).In this semester I
>> attend
>> > > in
>> > > > > >>>> lectures
>> > > > > >>>>>>>>>>>>>>>> that
>> > > > > >>>>>>>>>>>>>>>> called "Advanced Topics in Software Engineering"
>> by
>> > > > > >>> professor
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>> Diomidis
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>> Spinellis.
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>> As assignment I have to contribute in an open
>> source
>> > > > > >>> project.
>> > > > > >>>> I
>> > > > > >>>>>>>>>>>>>>>> would
>> > > > > >>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3. More
>> > specifically
>> > > I
>> > > > > >>>>>>>>>>>>>>>> understand
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>> that
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>> in
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>> big projects, like this, always exists work on
>> > > > integration
>> > > > > >>> and
>> > > > > >>>>>>>>>>>>>>>> collaboration between components and subsystems.
>> So
>> > I
>> > > do
>> > > > > >> not
>> > > > > >>>> have
>> > > > > >>>>>>>>>>>>>>>> any
>> > > > > >>>>>>>>>>>>>>>> problem to work on that. But I am more
>> interested in
>> > > > > >>> creative
>> > > > > >>>>>>>>>>>>>>>> work
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>> like
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>> implementation of some algorithm or on a new
>> > > functionality.
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>> I have to mention I have a hard constraint, that
>> my
>> > > > > >>>> contribution
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>> should
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>> be
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>> at least 100 - 200 lines of code.
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>> So I am writing you to ask if you have in mind
>> some
>> > > > > >>>>>>>>>>>>>>>> functionalities
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>> that
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>> I
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>> can help in development. Here some information
>> about
>> > my
>> > > > > >>>>>>>>>>>>>>>> knowledge in
>> > > > > >>>>>>>>>>>>>>>> software engineering and programming languages
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>>
>> > > http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>> inetpub/detfolio/.
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>> Thank you for your time and attention.
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>> Regards,
>> > > > > >>>>>>>>>>>>>>>> Christos Oikonomou
>> > > > > >>>>>>>>>>>>>>>> Assistant researcher at ISTLab
>> > > > > >>>>>>>>>>>>>>>>
>> > > > http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
>> > > > > >>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>>>
>> > > > > >>>>>>>>>>>
>> > > > > >>>>>>>>>>
>> > > > > >>>>>>>>>>
>> > > > > >>>>>>>>
>> > > > > >>>>>>
>> > > > > >>>>
>> > > > > >>>>
>> > > > > >>>
>> > > > > >>
>> > > > >
>> > > > >
>> > > >
>> > >
>> >
>>
>
>
Re: Contributing to tinkerpop3
Posted by Christos Oikonomou <ch...@gmail.com>.
I thought we can create an doc.xml with all the relative information
gathered for every function.
Although I see your point.
But I like also the idea of Matt.....
As I see this was something that interest you so I will start working on
how that should be implemented.
Regards,
Christos
On Sat, Apr 25, 2015 at 1:35 PM, Stephen Mallette <sp...@gmail.com>
wrote:
> Matt, I like idea for a :docimport command. By default we would load
> GraphTraversal into it so that
>
> gremlin> :doc outE
>
> could resolve to the appropriate javadoc right out the box. It is
> generally applicable and as you say might even be of interest to the groovy
> project at some point.
>
> Christos, I think the categories you mention are good, but I would take
> care to consider the source of the documentation. Where would those
> categories come from for you to display them? I don't think it would be
> especially helpful if we had to manage javadoc, the asciidoc and then
> another class of documentation for the console. I think that re-purposing
> the javadoc is the best approach here and if we write some good javadoc we
> will roughly cover your categories. You could obviously display the text
> of the javadoc, which would likely cover your first two categories (if
> written well). For the links, we could add @see tags as needed to the
> javadoc and those would be the links to display in the console.
>
>
>
>
>
> On Fri, Apr 24, 2015 at 7:13 PM, Christos Oikonomou <chrikon1994@gmail.com
> >
> wrote:
>
> > I am glad for your reaction.
> > I was thinking that we can display the information in 4 categories
> >
> > gremlin> :doc foo
> > Description of Functionality
> > .....
> > Some relevant functionalities
> > ......
> > Link to the user documentation
> > ......
> > Link to the javadoc
> > .........
> >
> > Do you believe that informations will be clear to all kinds of users
> >
> > On Sat, Apr 25, 2015 at 12:36 AM, Matt Frantz <
> matthew.h.frantz@gmail.com>
> > wrote:
> >
> > > Perhaps there should be a command to import the javadocs for a
> particular
> > > package or interface, e.g. a DSL interface. The effect would be to
> haul
> > > the methods into the global doc namespace. By default, we would apply
> > that
> > > to GraphTraversal.
> > >
> > > gremlin> :doc outE
> > > TODO: Write a good javadoc for each GraphTraversal method
> > > gremlin> :importdoc TinkerFactory.SocialTraversal
> > > gremlin> :doc people
> > > TODO: Write a good javadoc for each SocialTraversal method
> > >
> > > It could be applied to any class or interface. Applying it to a
> package
> > > would haul the classes and subpackages into the global doc namespace.
> > >
> > > gremlin> :importdoc org.apache.tinkerpop.gremlin.tinkergraph.structure
> > > gremlin> :doc TinkerHelper
> > > gremlin> :doc TinkerHelper.queryVertexIndex
> > >
> > > Maybe you could allow fully-qualified resolution without an import:
> > >
> > > gremlin> :doc
> > >
> > >
> >
> org.apache.tinkerpop.gremlin.tinkergraph.structure.TinkerHelper.queryVertexIndex
> > >
> > > This seems like something that could be contributed upstream to the
> > Groovy
> > > REPL.
> > >
> > > On Fri, Apr 24, 2015 at 12:10 PM, Stephen Mallette <
> spmallette@gmail.com
> > >
> > > wrote:
> > >
> > > > Yeah - it would be straightforward to bring in javadoc for the most
> > part:
> > > >
> > > > gremlin> :doc EdgeVertexStep
> > > >
> > > > you can get the class from that and full package name with reflection
> > > then
> > > > translate it to javadoc to extract some text to display in the
> console.
> > > I
> > > > guess that's nice, but no one knows VertexStep. They know this step
> > > > though:
> > > >
> > > > gremlin> :doc outE
> > > >
> > > > So - I guess the question is how one would go from just a pure
> javadoc
> > > > lookup command (cool but a bit less useful to a first time user who
> > > doesn't
> > > > know the classes - not that EdgeVertexStep would yield anything about
> > > outE
> > > > for that matter as it sits) to something that gives the user content
> on
> > > > steps from GraphTraversal which is the core of the DSL. And then -
> how
> > > > would it extend to other DSLs so that it was generally applicable to
> > > those
> > > > extending the language.
> > > >
> > > >
> > > >
> > > > On Fri, Apr 24, 2015 at 3:02 PM, Marko Rodriguez <
> okrammarko@gmail.com
> > >
> > > > wrote:
> > > >
> > > > > That would be really classy. It would be cool if that could be read
> > > from
> > > > > the JavaDoc somehow………… then we kill two birds with one stone.
> > > > >
> > > > > Marko.
> > > > >
> > > > > http://markorodriguez.com
> > > > >
> > > > > On Apr 24, 2015, at 12:08 PM, Stephen Mallette <
> spmallette@gmail.com
> > >
> > > > > wrote:
> > > > >
> > > > > >> A gremlin-command that display in gremlin-console user
> > documentation
> > > > or
> > > > > > javadocs of a gremlin functionality could be something that helps
> > > user?
> > > > > >
> > > > > > That's an interesting idea. I assume you are suggesting
> something
> > > > like:
> > > > > >
> > > > > > gremlin> :doc choose
> > > > > > ==>The choose()-step (branch) routes the current traverser to a
> > > > > particular
> > > > > > traversal branch option. With choose(), it is possible to
> > > > implement......
> > > > > >
> > > > > > Is that what you mean?
> > > > > >
> > > > > >
> > > > > >
> > > > > >
> > > > > > On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <
> > > > > chrikon1994@gmail.com>
> > > > > > wrote:
> > > > > >
> > > > > >> Hello and sorry for the delay. Thanks for the answers.
> > > > > >> I have done a general overview of all the code base. But more
> > > > > familiarized
> > > > > >> I am in gremlin-core and gremlin-console.
> > > > > >> I prefer the assignment of issues because I wants to help also
> to
> > > the
> > > > > >> faster achievement of the project planning in general.
> > > > > >> Also I have an idea in documentation. A gremlin-command that
> > display
> > > > in
> > > > > >> gremlin-console user documentation or javadocs of a gremlin
> > > > > functionality
> > > > > >> could be something that helps user?
> > > > > >>
> > > > > >> Regards,
> > > > > >> Christos
> > > > > >>
> > > > > >> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <
> > > > > m.ben.franklin@gmail.com>
> > > > > >> wrote:
> > > > > >>
> > > > > >>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <
> > > > okrammarko@gmail.com>
> > > > > >>> wrote:
> > > > > >>>
> > > > > >>>> Hi Christos,
> > > > > >>>>
> > > > > >>>> Given that you have familiarized yourself with the codebase,
> > which
> > > > > area
> > > > > >>> of
> > > > > >>>> the codebase do you feel:
> > > > > >>>>
> > > > > >>>> 1. you understand the best, and
> > > > > >>>> 2. are interested in working on.
> > > > > >>>>
> > > > > >>>> Given that information, I will be able to figure out something
> > > > > >> particular
> > > > > >>>> for you to do.
> > > > > >>>>
> > > > > >>>
> > > > > >>> You should also feel free to pick an issue off of JIRA
> yourself,
> > or
> > > > > even
> > > > > >>> create an issue and submit a patch for it.
> > > > > >>>
> > > > > >>>
> > > > > >>>>
> > > > > >>>> Thanks,
> > > > > >>>> Marko.
> > > > > >>>>
> > > > > >>>> http://markorodriguez.com
> > > > > >>>>
> > > > > >>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
> > > > > >> chrikon1994@gmail.com>
> > > > > >>>> wrote:
> > > > > >>>>
> > > > > >>>>> Hello everyone,
> > > > > >>>>>
> > > > > >>>>> I have read your advices how to start and how to be
> > familiarized
> > > > with
> > > > > >>> the
> > > > > >>>>> codebase. After some time I spent exploring the code, I
> > believe I
> > > > am
> > > > > >>>> ready
> > > > > >>>>> to start specific changes in the code.
> > > > > >>>>>
> > > > > >>>>> So am sending this message to ask you, if some of you have
> > ideas
> > > > > >> about
> > > > > >>>>> features or improvement and you want one more for help.
> > > > > >>>>>
> > > > > >>>>> Also if you have some issues you want some help please let me
> > > know
> > > > > >>> (jira
> > > > > >>>>> account chrikon).
> > > > > >>>>>
> > > > > >>>>> Thanks in advance,
> > > > > >>>>>
> > > > > >>>>> Regards
> > > > > >>>>> Christos
> > > > > >>>>>
> > > > > >>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <
> > > > > >>>> chrikon1994@gmail.com>
> > > > > >>>>> wrote:
> > > > > >>>>>
> > > > > >>>>>> Sorry Hadrian thank you for your correction, this will not
> > > happen
> > > > > >>> again!
> > > > > >>>>>>
> > > > > >>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <
> > > > > >> hzbarcea@gmail.com>
> > > > > >>>>>> wrote:
> > > > > >>>>>>
> > > > > >>>>>>> Hi Christos,
> > > > > >>>>>>>
> > > > > >>>>>>> First off, I am not a Mister :), just Hadrian.
> > > > > >>>>>>>
> > > > > >>>>>>> Yes, the idea is to collaborate, that's what open source is
> > > > about.
> > > > > >>>>>>>
> > > > > >>>>>>> Good luck,
> > > > > >>>>>>> Hadrian
> > > > > >>>>>>>
> > > > > >>>>>>>
> > > > > >>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
> > > > > >>>>>>>
> > > > > >>>>>>>> Firstly thank you all for your suggestions, all of them
> are
> > > very
> > > > > >>>> helpful.
> > > > > >>>>>>>>
> > > > > >>>>>>>> In this moment I follow the very good advice and I am
> > reading
> > > > > >>>>>>>> documentation, because next Wednesday I have to make a
> > > > > >> presentation
> > > > > >>>> for
> > > > > >>>>>>>> tinkerpop in front of my class!
> > > > > >>>>>>>>
> > > > > >>>>>>>> Marko I have to write code for my assignment, but in my
> free
> > > > time
> > > > > >> it
> > > > > >>>> is
> > > > > >>>>>>>> an
> > > > > >>>>>>>> interesting work.
> > > > > >>>>>>>>
> > > > > >>>>>>>> Although Javadoc it is applicable to my assignment, I
> > think. I
> > > > > >> will
> > > > > >>>> ask
> > > > > >>>>>>>> and
> > > > > >>>>>>>> I will have news.
> > > > > >>>>>>>>
> > > > > >>>>>>>> If Mr. Hadrian Zbarcea are working on it, I would like not
> > to
> > > > > >>>> interfere
> > > > > >>>>>>>> in
> > > > > >>>>>>>> your job, or we can cooperate.
> > > > > >>>>>>>> Before that discussion I have to contact to my academic
> > > > supervisor
> > > > > >>> in
> > > > > >>>>>>>> order
> > > > > >>>>>>>> to be 100% sure that this is ok.
> > > > > >>>>>>>>
> > > > > >>>>>>>> P.S. I hope my English is at least understandable, if not
> so
> > > > > >> please
> > > > > >>>> ask
> > > > > >>>>>>>> me
> > > > > >>>>>>>> again.
> > > > > >>>>>>>>
> > > > > >>>>>>>> Thank you all.
> > > > > >>>>>>>> Christos
> > > > > >>>>>>>>
> > > > > >>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <
> > > > > >>> hzbarcea@gmail.com>
> > > > > >>>>>>>> wrote:
> > > > > >>>>>>>>
> > > > > >>>>>>>> That's something I am interested in too.
> > > > > >>>>>>>>> Hadrian
> > > > > >>>>>>>>>
> > > > > >>>>>>>>>
> > > > > >>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
> > > > > >>>>>>>>>
> > > > > >>>>>>>>> Hi Christos,
> > > > > >>>>>>>>>>
> > > > > >>>>>>>>>> Another thing that we need is more JavaDoc! Its not
> sexy,
> > > but
> > > > > >> boy
> > > > > >>>> would
> > > > > >>>>>>>>>> be it be great to have someone go through and JavaDoc-up
> > > > > >>>> GraphTraversal
> > > > > >>>>>>>>>> (all those methods…).
> > > > > >>>>>>>>>>
> > > > > >>>>>>>>>>
> > https://github.com/apache/incubator-tinkerpop/blob/
> > > > > >>>>>>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
> > > > > >>>>>>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
> > > > > >>>>>>>>>>
> > > > > >>>>>>>>>> …the docs provide a description of each step.
> > > > > >>>>>>>>>>
> > > > > >>>>>>>>>>
> http://tinkerpop.incubator.apache.org/docs/3.0.0-
> > > > > >>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct clicking to
> > any
> > > > > >>>> particular
> > > > > >>>>>>>>>> step)
> > > > > >>>>>>>>>>
> > > > > >>>>>>>>>> I would say that would be more helpful now than a
> "Through
> > > the
> > > > > >>>>>>>>>> TinkerPop"-tutorial.
> > > > > >>>>>>>>>>
> > > > > >>>>>>>>>> Finally, what else would be helpful --- more test cases.
> > If
> > > > you
> > > > > >>> are
> > > > > >>>>>>>>>> interested in testing, I can get your set up in with "a
> > > > pattern"
> > > > > >>> so
> > > > > >>>>>>>>>> you pop
> > > > > >>>>>>>>>> out more process/ tests. For example:
> > > > > >>>>>>>>>>
> > > > > >>>>>>>>>>
> > https://github.com/apache/incubator-tinkerpop/blob/
> > > > > >>>>>>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
> > > > > >>>>>>>>>> gremlin/process/traversal/step/map/CountTest.java
> > > > > >>>>>>>>>>
> > > > > >>>>>>>>>> Thanks,
> > > > > >>>>>>>>>> Marko.
> > > > > >>>>>>>>>>
> > > > > >>>>>>>>>> http://markorodriguez.com
> > > > > >>>>>>>>>>
> > > > > >>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <
> > > > > >>> okrammarko@gmail.com>
> > > > > >>>>>>>>>> wrote:
> > > > > >>>>>>>>>>
> > > > > >>>>>>>>>> Hi Christos,
> > > > > >>>>>>>>>>
> > > > > >>>>>>>>>>>
> > > > > >>>>>>>>>>> Are you interested in writing code or perhaps, writing
> a
> > > > > >>> tutorial?
> > > > > >>>>>>>>>>>
> > > > > >>>>>>>>>>> It would be nice to have an in-depth tutorial on
> > > TinkerPop3.
> > > > > >> For
> > > > > >>>>>>>>>>> instance, find a reasonably sized dataset (<1 million
> > > edges),
> > > > > >>> parse
> > > > > >>>>>>>>>>> it into
> > > > > >>>>>>>>>>> a graph, do some analysis on it, expose it via Gremlin
> > > > Server,
> > > > > >>> OLTP
> > > > > >>>>>>>>>>> and
> > > > > >>>>>>>>>>> OLAP queries hitting it, etc. Write up the path you
> took
> > > into
> > > > > >> an
> > > > > >>>>>>>>>>> AsciiDoc
> > > > > >>>>>>>>>>> and we could put it on the Apache TinkerPop site as a
> > > > "Through
> > > > > >>> the
> > > > > >>>>>>>>>>> TinkerPop" tutorial. Be great if you could touch on
> every
> > > > > >> aspect
> > > > > >>> of
> > > > > >>>>>>>>>>> the
> > > > > >>>>>>>>>>> TinkerPop framework in the tutorial.
> > > > > >>>>>>>>>>>
> > > > > >>>>>>>>>>> I would appreciate a contribution like that.
> > > > > >>>>>>>>>>>
> > > > > >>>>>>>>>>> Thanks,
> > > > > >>>>>>>>>>> Marko.
> > > > > >>>>>>>>>>>
> > > > > >>>>>>>>>>> http://markorodriguez.com
> > > > > >>>>>>>>>>>
> > > > > >>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
> > > > > >>>> m.ben.franklin@gmail.com>
> > > > > >>>>>>>>>>> wrote:
> > > > > >>>>>>>>>>>
> > > > > >>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen Mallette <
> > > > > >>>>>>>>>>> spmallette@gmail.com>
> > > > > >>>>>>>>>>>
> > > > > >>>>>>>>>>>> wrote:
> > > > > >>>>>>>>>>>>
> > > > > >>>>>>>>>>>> My suggestion would be for you to spend some time
> > learning
> > > > > >>> about
> > > > > >>>>>>>>>>>>
> > > > > >>>>>>>>>>>>> TinkerPop
> > > > > >>>>>>>>>>>>> (reading the documentation, examining the code base,
> > > > perusing
> > > > > >>> the
> > > > > >>>>>>>>>>>>> Jira
> > > > > >>>>>>>>>>>>> issue tracker, etc.) to determine if any particular
> > part
> > > of
> > > > > >> the
> > > > > >>>>>>>>>>>>> stack
> > > > > >>>>>>>>>>>>> interests you.
> > > > > >>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>
> > > > > >>>>>>>>>>>> IMO, there is no better way to get involved than to
> pick
> > > > > >>> something
> > > > > >>>>>>>>>>>> that
> > > > > >>>>>>>>>>>> needs to be worked on and provide a patch for it. I
> > would
> > > > > >> look
> > > > > >>> at
> > > > > >>>>>>>>>>>> JIRA
> > > > > >>>>>>>>>>>> and
> > > > > >>>>>>>>>>>> find an issue that interests you.
> > > > > >>>>>>>>>>>>
> > > > > >>>>>>>>>>>>
> > > > > >>>>>>>>>>>> In doing that, you might develop your own ideas as to
> > > > > >>>>>>>>>>>>
> > > > > >>>>>>>>>>>>> where/what you think you are best suited to
> contribute.
> > > At
> > > > > >>> that
> > > > > >>>>>>>>>>>>> point
> > > > > >>>>>>>>>>>>> you
> > > > > >>>>>>>>>>>>> could post those ideas here in the mailing list for
> > > > feedback.
> > > > > >>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos Oikonomou <
> > > > > >>>>>>>>>>>>> chrikon1994@gmail.com
> > > > > >>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>> wrote:
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>> Hi Stephen
> > > > > >>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>> When I start I was not familiar with the project nor
> > the
> > > > > >>>>>>>>>>>>>> architecture/codebase.
> > > > > >>>>>>>>>>>>>> But I am reading about tinkerpop and searching in
> the
> > > code
> > > > > >> and
> > > > > >>>>>>>>>>>>>> I am thinking to make some simple examples in order
> to
> > > be
> > > > > >> more
> > > > > >>>>>>>>>>>>>> familiar
> > > > > >>>>>>>>>>>>>> with the functionality.
> > > > > >>>>>>>>>>>>>> So I am not now very familiar but I try to be in the
> > > near
> > > > > >>>> future.
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>> Christos
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen Mallette <
> > > > > >>>>>>>>>>>>>> spmallette@gmail.com>
> > > > > >>>>>>>>>>>>>> wrote:
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>> Hi Christos, we appreciate your offer to contribute.
> > > > Could
> > > > > >>> you
> > > > > >>>>>>>>>>>>>> tell
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>> us
> > > > > >>>>>>>>>>>>>>> what kind of experience you have with TinkerPop so
> > far?
> > > > > >> Are
> > > > > >>>> you
> > > > > >>>>>>>>>>>>>>> at
> > > > > >>>>>>>>>>>>>>> all
> > > > > >>>>>>>>>>>>>>> familiar with the architecture/codebase?
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>> Stephen
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos
> Oikonomou
> > <
> > > > > >>>>>>>>>>>>>>> chrikon1994@gmail.com>
> > > > > >>>>>>>>>>>>>>> wrote:
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>> Dear Tinkerpop Development Team
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>> My name is Christos Economou.
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>> I would like to contribute in the tinkerpop3.
> > > > > >>>>>>>>>>>>>>>> This contribution will be a part of an assignment
> in
> > > one
> > > > > >> of
> > > > > >>> my
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>> classes.
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>> I am in my third year of study at Athens University
> of
> > > > > >>> Economics
> > > > > >>>>>>>>>>>>>>>> and
> > > > > >>>>>>>>>>>>>>>> Business (Greece | Hellas).In this semester I
> attend
> > > in
> > > > > >>>> lectures
> > > > > >>>>>>>>>>>>>>>> that
> > > > > >>>>>>>>>>>>>>>> called "Advanced Topics in Software Engineering"
> by
> > > > > >>> professor
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>> Diomidis
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>> Spinellis.
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>> As assignment I have to contribute in an open
> source
> > > > > >>> project.
> > > > > >>>> I
> > > > > >>>>>>>>>>>>>>>> would
> > > > > >>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3. More
> > specifically
> > > I
> > > > > >>>>>>>>>>>>>>>> understand
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>> that
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>> in
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>> big projects, like this, always exists work on
> > > > integration
> > > > > >>> and
> > > > > >>>>>>>>>>>>>>>> collaboration between components and subsystems.
> So
> > I
> > > do
> > > > > >> not
> > > > > >>>> have
> > > > > >>>>>>>>>>>>>>>> any
> > > > > >>>>>>>>>>>>>>>> problem to work on that. But I am more interested
> in
> > > > > >>> creative
> > > > > >>>>>>>>>>>>>>>> work
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>> like
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>> implementation of some algorithm or on a new
> > > functionality.
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>> I have to mention I have a hard constraint, that
> my
> > > > > >>>> contribution
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>> should
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>> be
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>> at least 100 - 200 lines of code.
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>> So I am writing you to ask if you have in mind
> some
> > > > > >>>>>>>>>>>>>>>> functionalities
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>> that
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>> I
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>> can help in development. Here some information
> about
> > my
> > > > > >>>>>>>>>>>>>>>> knowledge in
> > > > > >>>>>>>>>>>>>>>> software engineering and programming languages
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>>
> > > http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>> inetpub/detfolio/.
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>> Thank you for your time and attention.
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>> Regards,
> > > > > >>>>>>>>>>>>>>>> Christos Oikonomou
> > > > > >>>>>>>>>>>>>>>> Assistant researcher at ISTLab
> > > > > >>>>>>>>>>>>>>>>
> > > > http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
> > > > > >>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>>
> > > > > >>>>>>>>>>>>>
> > > > > >>>>>>>>>>>
> > > > > >>>>>>>>>>
> > > > > >>>>>>>>>>
> > > > > >>>>>>>>
> > > > > >>>>>>
> > > > > >>>>
> > > > > >>>>
> > > > > >>>
> > > > > >>
> > > > >
> > > > >
> > > >
> > >
> >
>
Re: Contributing to tinkerpop3
Posted by Stephen Mallette <sp...@gmail.com>.
Matt, I like idea for a :docimport command. By default we would load
GraphTraversal into it so that
gremlin> :doc outE
could resolve to the appropriate javadoc right out the box. It is
generally applicable and as you say might even be of interest to the groovy
project at some point.
Christos, I think the categories you mention are good, but I would take
care to consider the source of the documentation. Where would those
categories come from for you to display them? I don't think it would be
especially helpful if we had to manage javadoc, the asciidoc and then
another class of documentation for the console. I think that re-purposing
the javadoc is the best approach here and if we write some good javadoc we
will roughly cover your categories. You could obviously display the text
of the javadoc, which would likely cover your first two categories (if
written well). For the links, we could add @see tags as needed to the
javadoc and those would be the links to display in the console.
On Fri, Apr 24, 2015 at 7:13 PM, Christos Oikonomou <ch...@gmail.com>
wrote:
> I am glad for your reaction.
> I was thinking that we can display the information in 4 categories
>
> gremlin> :doc foo
> Description of Functionality
> .....
> Some relevant functionalities
> ......
> Link to the user documentation
> ......
> Link to the javadoc
> .........
>
> Do you believe that informations will be clear to all kinds of users
>
> On Sat, Apr 25, 2015 at 12:36 AM, Matt Frantz <ma...@gmail.com>
> wrote:
>
> > Perhaps there should be a command to import the javadocs for a particular
> > package or interface, e.g. a DSL interface. The effect would be to haul
> > the methods into the global doc namespace. By default, we would apply
> that
> > to GraphTraversal.
> >
> > gremlin> :doc outE
> > TODO: Write a good javadoc for each GraphTraversal method
> > gremlin> :importdoc TinkerFactory.SocialTraversal
> > gremlin> :doc people
> > TODO: Write a good javadoc for each SocialTraversal method
> >
> > It could be applied to any class or interface. Applying it to a package
> > would haul the classes and subpackages into the global doc namespace.
> >
> > gremlin> :importdoc org.apache.tinkerpop.gremlin.tinkergraph.structure
> > gremlin> :doc TinkerHelper
> > gremlin> :doc TinkerHelper.queryVertexIndex
> >
> > Maybe you could allow fully-qualified resolution without an import:
> >
> > gremlin> :doc
> >
> >
> org.apache.tinkerpop.gremlin.tinkergraph.structure.TinkerHelper.queryVertexIndex
> >
> > This seems like something that could be contributed upstream to the
> Groovy
> > REPL.
> >
> > On Fri, Apr 24, 2015 at 12:10 PM, Stephen Mallette <spmallette@gmail.com
> >
> > wrote:
> >
> > > Yeah - it would be straightforward to bring in javadoc for the most
> part:
> > >
> > > gremlin> :doc EdgeVertexStep
> > >
> > > you can get the class from that and full package name with reflection
> > then
> > > translate it to javadoc to extract some text to display in the console.
> > I
> > > guess that's nice, but no one knows VertexStep. They know this step
> > > though:
> > >
> > > gremlin> :doc outE
> > >
> > > So - I guess the question is how one would go from just a pure javadoc
> > > lookup command (cool but a bit less useful to a first time user who
> > doesn't
> > > know the classes - not that EdgeVertexStep would yield anything about
> > outE
> > > for that matter as it sits) to something that gives the user content on
> > > steps from GraphTraversal which is the core of the DSL. And then - how
> > > would it extend to other DSLs so that it was generally applicable to
> > those
> > > extending the language.
> > >
> > >
> > >
> > > On Fri, Apr 24, 2015 at 3:02 PM, Marko Rodriguez <okrammarko@gmail.com
> >
> > > wrote:
> > >
> > > > That would be really classy. It would be cool if that could be read
> > from
> > > > the JavaDoc somehow………… then we kill two birds with one stone.
> > > >
> > > > Marko.
> > > >
> > > > http://markorodriguez.com
> > > >
> > > > On Apr 24, 2015, at 12:08 PM, Stephen Mallette <spmallette@gmail.com
> >
> > > > wrote:
> > > >
> > > > >> A gremlin-command that display in gremlin-console user
> documentation
> > > or
> > > > > javadocs of a gremlin functionality could be something that helps
> > user?
> > > > >
> > > > > That's an interesting idea. I assume you are suggesting something
> > > like:
> > > > >
> > > > > gremlin> :doc choose
> > > > > ==>The choose()-step (branch) routes the current traverser to a
> > > > particular
> > > > > traversal branch option. With choose(), it is possible to
> > > implement......
> > > > >
> > > > > Is that what you mean?
> > > > >
> > > > >
> > > > >
> > > > >
> > > > > On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <
> > > > chrikon1994@gmail.com>
> > > > > wrote:
> > > > >
> > > > >> Hello and sorry for the delay. Thanks for the answers.
> > > > >> I have done a general overview of all the code base. But more
> > > > familiarized
> > > > >> I am in gremlin-core and gremlin-console.
> > > > >> I prefer the assignment of issues because I wants to help also to
> > the
> > > > >> faster achievement of the project planning in general.
> > > > >> Also I have an idea in documentation. A gremlin-command that
> display
> > > in
> > > > >> gremlin-console user documentation or javadocs of a gremlin
> > > > functionality
> > > > >> could be something that helps user?
> > > > >>
> > > > >> Regards,
> > > > >> Christos
> > > > >>
> > > > >> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <
> > > > m.ben.franklin@gmail.com>
> > > > >> wrote:
> > > > >>
> > > > >>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <
> > > okrammarko@gmail.com>
> > > > >>> wrote:
> > > > >>>
> > > > >>>> Hi Christos,
> > > > >>>>
> > > > >>>> Given that you have familiarized yourself with the codebase,
> which
> > > > area
> > > > >>> of
> > > > >>>> the codebase do you feel:
> > > > >>>>
> > > > >>>> 1. you understand the best, and
> > > > >>>> 2. are interested in working on.
> > > > >>>>
> > > > >>>> Given that information, I will be able to figure out something
> > > > >> particular
> > > > >>>> for you to do.
> > > > >>>>
> > > > >>>
> > > > >>> You should also feel free to pick an issue off of JIRA yourself,
> or
> > > > even
> > > > >>> create an issue and submit a patch for it.
> > > > >>>
> > > > >>>
> > > > >>>>
> > > > >>>> Thanks,
> > > > >>>> Marko.
> > > > >>>>
> > > > >>>> http://markorodriguez.com
> > > > >>>>
> > > > >>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
> > > > >> chrikon1994@gmail.com>
> > > > >>>> wrote:
> > > > >>>>
> > > > >>>>> Hello everyone,
> > > > >>>>>
> > > > >>>>> I have read your advices how to start and how to be
> familiarized
> > > with
> > > > >>> the
> > > > >>>>> codebase. After some time I spent exploring the code, I
> believe I
> > > am
> > > > >>>> ready
> > > > >>>>> to start specific changes in the code.
> > > > >>>>>
> > > > >>>>> So am sending this message to ask you, if some of you have
> ideas
> > > > >> about
> > > > >>>>> features or improvement and you want one more for help.
> > > > >>>>>
> > > > >>>>> Also if you have some issues you want some help please let me
> > know
> > > > >>> (jira
> > > > >>>>> account chrikon).
> > > > >>>>>
> > > > >>>>> Thanks in advance,
> > > > >>>>>
> > > > >>>>> Regards
> > > > >>>>> Christos
> > > > >>>>>
> > > > >>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <
> > > > >>>> chrikon1994@gmail.com>
> > > > >>>>> wrote:
> > > > >>>>>
> > > > >>>>>> Sorry Hadrian thank you for your correction, this will not
> > happen
> > > > >>> again!
> > > > >>>>>>
> > > > >>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <
> > > > >> hzbarcea@gmail.com>
> > > > >>>>>> wrote:
> > > > >>>>>>
> > > > >>>>>>> Hi Christos,
> > > > >>>>>>>
> > > > >>>>>>> First off, I am not a Mister :), just Hadrian.
> > > > >>>>>>>
> > > > >>>>>>> Yes, the idea is to collaborate, that's what open source is
> > > about.
> > > > >>>>>>>
> > > > >>>>>>> Good luck,
> > > > >>>>>>> Hadrian
> > > > >>>>>>>
> > > > >>>>>>>
> > > > >>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
> > > > >>>>>>>
> > > > >>>>>>>> Firstly thank you all for your suggestions, all of them are
> > very
> > > > >>>> helpful.
> > > > >>>>>>>>
> > > > >>>>>>>> In this moment I follow the very good advice and I am
> reading
> > > > >>>>>>>> documentation, because next Wednesday I have to make a
> > > > >> presentation
> > > > >>>> for
> > > > >>>>>>>> tinkerpop in front of my class!
> > > > >>>>>>>>
> > > > >>>>>>>> Marko I have to write code for my assignment, but in my free
> > > time
> > > > >> it
> > > > >>>> is
> > > > >>>>>>>> an
> > > > >>>>>>>> interesting work.
> > > > >>>>>>>>
> > > > >>>>>>>> Although Javadoc it is applicable to my assignment, I
> think. I
> > > > >> will
> > > > >>>> ask
> > > > >>>>>>>> and
> > > > >>>>>>>> I will have news.
> > > > >>>>>>>>
> > > > >>>>>>>> If Mr. Hadrian Zbarcea are working on it, I would like not
> to
> > > > >>>> interfere
> > > > >>>>>>>> in
> > > > >>>>>>>> your job, or we can cooperate.
> > > > >>>>>>>> Before that discussion I have to contact to my academic
> > > supervisor
> > > > >>> in
> > > > >>>>>>>> order
> > > > >>>>>>>> to be 100% sure that this is ok.
> > > > >>>>>>>>
> > > > >>>>>>>> P.S. I hope my English is at least understandable, if not so
> > > > >> please
> > > > >>>> ask
> > > > >>>>>>>> me
> > > > >>>>>>>> again.
> > > > >>>>>>>>
> > > > >>>>>>>> Thank you all.
> > > > >>>>>>>> Christos
> > > > >>>>>>>>
> > > > >>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <
> > > > >>> hzbarcea@gmail.com>
> > > > >>>>>>>> wrote:
> > > > >>>>>>>>
> > > > >>>>>>>> That's something I am interested in too.
> > > > >>>>>>>>> Hadrian
> > > > >>>>>>>>>
> > > > >>>>>>>>>
> > > > >>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
> > > > >>>>>>>>>
> > > > >>>>>>>>> Hi Christos,
> > > > >>>>>>>>>>
> > > > >>>>>>>>>> Another thing that we need is more JavaDoc! Its not sexy,
> > but
> > > > >> boy
> > > > >>>> would
> > > > >>>>>>>>>> be it be great to have someone go through and JavaDoc-up
> > > > >>>> GraphTraversal
> > > > >>>>>>>>>> (all those methods…).
> > > > >>>>>>>>>>
> > > > >>>>>>>>>>
> https://github.com/apache/incubator-tinkerpop/blob/
> > > > >>>>>>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
> > > > >>>>>>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
> > > > >>>>>>>>>>
> > > > >>>>>>>>>> …the docs provide a description of each step.
> > > > >>>>>>>>>>
> > > > >>>>>>>>>> http://tinkerpop.incubator.apache.org/docs/3.0.0-
> > > > >>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct clicking to
> any
> > > > >>>> particular
> > > > >>>>>>>>>> step)
> > > > >>>>>>>>>>
> > > > >>>>>>>>>> I would say that would be more helpful now than a "Through
> > the
> > > > >>>>>>>>>> TinkerPop"-tutorial.
> > > > >>>>>>>>>>
> > > > >>>>>>>>>> Finally, what else would be helpful --- more test cases.
> If
> > > you
> > > > >>> are
> > > > >>>>>>>>>> interested in testing, I can get your set up in with "a
> > > pattern"
> > > > >>> so
> > > > >>>>>>>>>> you pop
> > > > >>>>>>>>>> out more process/ tests. For example:
> > > > >>>>>>>>>>
> > > > >>>>>>>>>>
> https://github.com/apache/incubator-tinkerpop/blob/
> > > > >>>>>>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
> > > > >>>>>>>>>> gremlin/process/traversal/step/map/CountTest.java
> > > > >>>>>>>>>>
> > > > >>>>>>>>>> Thanks,
> > > > >>>>>>>>>> Marko.
> > > > >>>>>>>>>>
> > > > >>>>>>>>>> http://markorodriguez.com
> > > > >>>>>>>>>>
> > > > >>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <
> > > > >>> okrammarko@gmail.com>
> > > > >>>>>>>>>> wrote:
> > > > >>>>>>>>>>
> > > > >>>>>>>>>> Hi Christos,
> > > > >>>>>>>>>>
> > > > >>>>>>>>>>>
> > > > >>>>>>>>>>> Are you interested in writing code or perhaps, writing a
> > > > >>> tutorial?
> > > > >>>>>>>>>>>
> > > > >>>>>>>>>>> It would be nice to have an in-depth tutorial on
> > TinkerPop3.
> > > > >> For
> > > > >>>>>>>>>>> instance, find a reasonably sized dataset (<1 million
> > edges),
> > > > >>> parse
> > > > >>>>>>>>>>> it into
> > > > >>>>>>>>>>> a graph, do some analysis on it, expose it via Gremlin
> > > Server,
> > > > >>> OLTP
> > > > >>>>>>>>>>> and
> > > > >>>>>>>>>>> OLAP queries hitting it, etc. Write up the path you took
> > into
> > > > >> an
> > > > >>>>>>>>>>> AsciiDoc
> > > > >>>>>>>>>>> and we could put it on the Apache TinkerPop site as a
> > > "Through
> > > > >>> the
> > > > >>>>>>>>>>> TinkerPop" tutorial. Be great if you could touch on every
> > > > >> aspect
> > > > >>> of
> > > > >>>>>>>>>>> the
> > > > >>>>>>>>>>> TinkerPop framework in the tutorial.
> > > > >>>>>>>>>>>
> > > > >>>>>>>>>>> I would appreciate a contribution like that.
> > > > >>>>>>>>>>>
> > > > >>>>>>>>>>> Thanks,
> > > > >>>>>>>>>>> Marko.
> > > > >>>>>>>>>>>
> > > > >>>>>>>>>>> http://markorodriguez.com
> > > > >>>>>>>>>>>
> > > > >>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
> > > > >>>> m.ben.franklin@gmail.com>
> > > > >>>>>>>>>>> wrote:
> > > > >>>>>>>>>>>
> > > > >>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen Mallette <
> > > > >>>>>>>>>>> spmallette@gmail.com>
> > > > >>>>>>>>>>>
> > > > >>>>>>>>>>>> wrote:
> > > > >>>>>>>>>>>>
> > > > >>>>>>>>>>>> My suggestion would be for you to spend some time
> learning
> > > > >>> about
> > > > >>>>>>>>>>>>
> > > > >>>>>>>>>>>>> TinkerPop
> > > > >>>>>>>>>>>>> (reading the documentation, examining the code base,
> > > perusing
> > > > >>> the
> > > > >>>>>>>>>>>>> Jira
> > > > >>>>>>>>>>>>> issue tracker, etc.) to determine if any particular
> part
> > of
> > > > >> the
> > > > >>>>>>>>>>>>> stack
> > > > >>>>>>>>>>>>> interests you.
> > > > >>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>
> > > > >>>>>>>>>>>>
> > > > >>>>>>>>>>>> IMO, there is no better way to get involved than to pick
> > > > >>> something
> > > > >>>>>>>>>>>> that
> > > > >>>>>>>>>>>> needs to be worked on and provide a patch for it. I
> would
> > > > >> look
> > > > >>> at
> > > > >>>>>>>>>>>> JIRA
> > > > >>>>>>>>>>>> and
> > > > >>>>>>>>>>>> find an issue that interests you.
> > > > >>>>>>>>>>>>
> > > > >>>>>>>>>>>>
> > > > >>>>>>>>>>>> In doing that, you might develop your own ideas as to
> > > > >>>>>>>>>>>>
> > > > >>>>>>>>>>>>> where/what you think you are best suited to contribute.
> > At
> > > > >>> that
> > > > >>>>>>>>>>>>> point
> > > > >>>>>>>>>>>>> you
> > > > >>>>>>>>>>>>> could post those ideas here in the mailing list for
> > > feedback.
> > > > >>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>
> > > > >>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos Oikonomou <
> > > > >>>>>>>>>>>>> chrikon1994@gmail.com
> > > > >>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>> wrote:
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>
> > > > >>>>>>>>>>>>> Hi Stephen
> > > > >>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>> When I start I was not familiar with the project nor
> the
> > > > >>>>>>>>>>>>>> architecture/codebase.
> > > > >>>>>>>>>>>>>> But I am reading about tinkerpop and searching in the
> > code
> > > > >> and
> > > > >>>>>>>>>>>>>> I am thinking to make some simple examples in order to
> > be
> > > > >> more
> > > > >>>>>>>>>>>>>> familiar
> > > > >>>>>>>>>>>>>> with the functionality.
> > > > >>>>>>>>>>>>>> So I am not now very familiar but I try to be in the
> > near
> > > > >>>> future.
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>> Christos
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen Mallette <
> > > > >>>>>>>>>>>>>> spmallette@gmail.com>
> > > > >>>>>>>>>>>>>> wrote:
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>> Hi Christos, we appreciate your offer to contribute.
> > > Could
> > > > >>> you
> > > > >>>>>>>>>>>>>> tell
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>> us
> > > > >>>>>>>>>>>>>>> what kind of experience you have with TinkerPop so
> far?
> > > > >> Are
> > > > >>>> you
> > > > >>>>>>>>>>>>>>> at
> > > > >>>>>>>>>>>>>>> all
> > > > >>>>>>>>>>>>>>> familiar with the architecture/codebase?
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>> Stephen
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos Oikonomou
> <
> > > > >>>>>>>>>>>>>>> chrikon1994@gmail.com>
> > > > >>>>>>>>>>>>>>> wrote:
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>> Dear Tinkerpop Development Team
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>> My name is Christos Economou.
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>> I would like to contribute in the tinkerpop3.
> > > > >>>>>>>>>>>>>>>> This contribution will be a part of an assignment in
> > one
> > > > >> of
> > > > >>> my
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>> classes.
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>> I am in my third year of study at Athens University of
> > > > >>> Economics
> > > > >>>>>>>>>>>>>>>> and
> > > > >>>>>>>>>>>>>>>> Business (Greece | Hellas).In this semester I attend
> > in
> > > > >>>> lectures
> > > > >>>>>>>>>>>>>>>> that
> > > > >>>>>>>>>>>>>>>> called "Advanced Topics in Software Engineering" by
> > > > >>> professor
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>> Diomidis
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>> Spinellis.
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>> As assignment I have to contribute in an open source
> > > > >>> project.
> > > > >>>> I
> > > > >>>>>>>>>>>>>>>> would
> > > > >>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3. More
> specifically
> > I
> > > > >>>>>>>>>>>>>>>> understand
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>> that
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>> in
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>> big projects, like this, always exists work on
> > > integration
> > > > >>> and
> > > > >>>>>>>>>>>>>>>> collaboration between components and subsystems. So
> I
> > do
> > > > >> not
> > > > >>>> have
> > > > >>>>>>>>>>>>>>>> any
> > > > >>>>>>>>>>>>>>>> problem to work on that. But I am more interested in
> > > > >>> creative
> > > > >>>>>>>>>>>>>>>> work
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>> like
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>> implementation of some algorithm or on a new
> > functionality.
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>> I have to mention I have a hard constraint, that my
> > > > >>>> contribution
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>> should
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>> be
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>> at least 100 - 200 lines of code.
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>> So I am writing you to ask if you have in mind some
> > > > >>>>>>>>>>>>>>>> functionalities
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>> that
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>> I
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>> can help in development. Here some information about
> my
> > > > >>>>>>>>>>>>>>>> knowledge in
> > > > >>>>>>>>>>>>>>>> software engineering and programming languages
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>>
> > http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>> inetpub/detfolio/.
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>> Thank you for your time and attention.
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>> Regards,
> > > > >>>>>>>>>>>>>>>> Christos Oikonomou
> > > > >>>>>>>>>>>>>>>> Assistant researcher at ISTLab
> > > > >>>>>>>>>>>>>>>>
> > > http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
> > > > >>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>>
> > > > >>>>>>>>>>>>>
> > > > >>>>>>>>>>>
> > > > >>>>>>>>>>
> > > > >>>>>>>>>>
> > > > >>>>>>>>
> > > > >>>>>>
> > > > >>>>
> > > > >>>>
> > > > >>>
> > > > >>
> > > >
> > > >
> > >
> >
>
Re: Contributing to tinkerpop3
Posted by Christos Oikonomou <ch...@gmail.com>.
I am glad for your reaction.
I was thinking that we can display the information in 4 categories
gremlin> :doc foo
Description of Functionality
.....
Some relevant functionalities
......
Link to the user documentation
......
Link to the javadoc
.........
Do you believe that informations will be clear to all kinds of users
On Sat, Apr 25, 2015 at 12:36 AM, Matt Frantz <ma...@gmail.com>
wrote:
> Perhaps there should be a command to import the javadocs for a particular
> package or interface, e.g. a DSL interface. The effect would be to haul
> the methods into the global doc namespace. By default, we would apply that
> to GraphTraversal.
>
> gremlin> :doc outE
> TODO: Write a good javadoc for each GraphTraversal method
> gremlin> :importdoc TinkerFactory.SocialTraversal
> gremlin> :doc people
> TODO: Write a good javadoc for each SocialTraversal method
>
> It could be applied to any class or interface. Applying it to a package
> would haul the classes and subpackages into the global doc namespace.
>
> gremlin> :importdoc org.apache.tinkerpop.gremlin.tinkergraph.structure
> gremlin> :doc TinkerHelper
> gremlin> :doc TinkerHelper.queryVertexIndex
>
> Maybe you could allow fully-qualified resolution without an import:
>
> gremlin> :doc
>
> org.apache.tinkerpop.gremlin.tinkergraph.structure.TinkerHelper.queryVertexIndex
>
> This seems like something that could be contributed upstream to the Groovy
> REPL.
>
> On Fri, Apr 24, 2015 at 12:10 PM, Stephen Mallette <sp...@gmail.com>
> wrote:
>
> > Yeah - it would be straightforward to bring in javadoc for the most part:
> >
> > gremlin> :doc EdgeVertexStep
> >
> > you can get the class from that and full package name with reflection
> then
> > translate it to javadoc to extract some text to display in the console.
> I
> > guess that's nice, but no one knows VertexStep. They know this step
> > though:
> >
> > gremlin> :doc outE
> >
> > So - I guess the question is how one would go from just a pure javadoc
> > lookup command (cool but a bit less useful to a first time user who
> doesn't
> > know the classes - not that EdgeVertexStep would yield anything about
> outE
> > for that matter as it sits) to something that gives the user content on
> > steps from GraphTraversal which is the core of the DSL. And then - how
> > would it extend to other DSLs so that it was generally applicable to
> those
> > extending the language.
> >
> >
> >
> > On Fri, Apr 24, 2015 at 3:02 PM, Marko Rodriguez <ok...@gmail.com>
> > wrote:
> >
> > > That would be really classy. It would be cool if that could be read
> from
> > > the JavaDoc somehow………… then we kill two birds with one stone.
> > >
> > > Marko.
> > >
> > > http://markorodriguez.com
> > >
> > > On Apr 24, 2015, at 12:08 PM, Stephen Mallette <sp...@gmail.com>
> > > wrote:
> > >
> > > >> A gremlin-command that display in gremlin-console user documentation
> > or
> > > > javadocs of a gremlin functionality could be something that helps
> user?
> > > >
> > > > That's an interesting idea. I assume you are suggesting something
> > like:
> > > >
> > > > gremlin> :doc choose
> > > > ==>The choose()-step (branch) routes the current traverser to a
> > > particular
> > > > traversal branch option. With choose(), it is possible to
> > implement......
> > > >
> > > > Is that what you mean?
> > > >
> > > >
> > > >
> > > >
> > > > On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <
> > > chrikon1994@gmail.com>
> > > > wrote:
> > > >
> > > >> Hello and sorry for the delay. Thanks for the answers.
> > > >> I have done a general overview of all the code base. But more
> > > familiarized
> > > >> I am in gremlin-core and gremlin-console.
> > > >> I prefer the assignment of issues because I wants to help also to
> the
> > > >> faster achievement of the project planning in general.
> > > >> Also I have an idea in documentation. A gremlin-command that display
> > in
> > > >> gremlin-console user documentation or javadocs of a gremlin
> > > functionality
> > > >> could be something that helps user?
> > > >>
> > > >> Regards,
> > > >> Christos
> > > >>
> > > >> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <
> > > m.ben.franklin@gmail.com>
> > > >> wrote:
> > > >>
> > > >>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <
> > okrammarko@gmail.com>
> > > >>> wrote:
> > > >>>
> > > >>>> Hi Christos,
> > > >>>>
> > > >>>> Given that you have familiarized yourself with the codebase, which
> > > area
> > > >>> of
> > > >>>> the codebase do you feel:
> > > >>>>
> > > >>>> 1. you understand the best, and
> > > >>>> 2. are interested in working on.
> > > >>>>
> > > >>>> Given that information, I will be able to figure out something
> > > >> particular
> > > >>>> for you to do.
> > > >>>>
> > > >>>
> > > >>> You should also feel free to pick an issue off of JIRA yourself, or
> > > even
> > > >>> create an issue and submit a patch for it.
> > > >>>
> > > >>>
> > > >>>>
> > > >>>> Thanks,
> > > >>>> Marko.
> > > >>>>
> > > >>>> http://markorodriguez.com
> > > >>>>
> > > >>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
> > > >> chrikon1994@gmail.com>
> > > >>>> wrote:
> > > >>>>
> > > >>>>> Hello everyone,
> > > >>>>>
> > > >>>>> I have read your advices how to start and how to be familiarized
> > with
> > > >>> the
> > > >>>>> codebase. After some time I spent exploring the code, I believe I
> > am
> > > >>>> ready
> > > >>>>> to start specific changes in the code.
> > > >>>>>
> > > >>>>> So am sending this message to ask you, if some of you have ideas
> > > >> about
> > > >>>>> features or improvement and you want one more for help.
> > > >>>>>
> > > >>>>> Also if you have some issues you want some help please let me
> know
> > > >>> (jira
> > > >>>>> account chrikon).
> > > >>>>>
> > > >>>>> Thanks in advance,
> > > >>>>>
> > > >>>>> Regards
> > > >>>>> Christos
> > > >>>>>
> > > >>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <
> > > >>>> chrikon1994@gmail.com>
> > > >>>>> wrote:
> > > >>>>>
> > > >>>>>> Sorry Hadrian thank you for your correction, this will not
> happen
> > > >>> again!
> > > >>>>>>
> > > >>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <
> > > >> hzbarcea@gmail.com>
> > > >>>>>> wrote:
> > > >>>>>>
> > > >>>>>>> Hi Christos,
> > > >>>>>>>
> > > >>>>>>> First off, I am not a Mister :), just Hadrian.
> > > >>>>>>>
> > > >>>>>>> Yes, the idea is to collaborate, that's what open source is
> > about.
> > > >>>>>>>
> > > >>>>>>> Good luck,
> > > >>>>>>> Hadrian
> > > >>>>>>>
> > > >>>>>>>
> > > >>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
> > > >>>>>>>
> > > >>>>>>>> Firstly thank you all for your suggestions, all of them are
> very
> > > >>>> helpful.
> > > >>>>>>>>
> > > >>>>>>>> In this moment I follow the very good advice and I am reading
> > > >>>>>>>> documentation, because next Wednesday I have to make a
> > > >> presentation
> > > >>>> for
> > > >>>>>>>> tinkerpop in front of my class!
> > > >>>>>>>>
> > > >>>>>>>> Marko I have to write code for my assignment, but in my free
> > time
> > > >> it
> > > >>>> is
> > > >>>>>>>> an
> > > >>>>>>>> interesting work.
> > > >>>>>>>>
> > > >>>>>>>> Although Javadoc it is applicable to my assignment, I think. I
> > > >> will
> > > >>>> ask
> > > >>>>>>>> and
> > > >>>>>>>> I will have news.
> > > >>>>>>>>
> > > >>>>>>>> If Mr. Hadrian Zbarcea are working on it, I would like not to
> > > >>>> interfere
> > > >>>>>>>> in
> > > >>>>>>>> your job, or we can cooperate.
> > > >>>>>>>> Before that discussion I have to contact to my academic
> > supervisor
> > > >>> in
> > > >>>>>>>> order
> > > >>>>>>>> to be 100% sure that this is ok.
> > > >>>>>>>>
> > > >>>>>>>> P.S. I hope my English is at least understandable, if not so
> > > >> please
> > > >>>> ask
> > > >>>>>>>> me
> > > >>>>>>>> again.
> > > >>>>>>>>
> > > >>>>>>>> Thank you all.
> > > >>>>>>>> Christos
> > > >>>>>>>>
> > > >>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <
> > > >>> hzbarcea@gmail.com>
> > > >>>>>>>> wrote:
> > > >>>>>>>>
> > > >>>>>>>> That's something I am interested in too.
> > > >>>>>>>>> Hadrian
> > > >>>>>>>>>
> > > >>>>>>>>>
> > > >>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
> > > >>>>>>>>>
> > > >>>>>>>>> Hi Christos,
> > > >>>>>>>>>>
> > > >>>>>>>>>> Another thing that we need is more JavaDoc! Its not sexy,
> but
> > > >> boy
> > > >>>> would
> > > >>>>>>>>>> be it be great to have someone go through and JavaDoc-up
> > > >>>> GraphTraversal
> > > >>>>>>>>>> (all those methods…).
> > > >>>>>>>>>>
> > > >>>>>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
> > > >>>>>>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
> > > >>>>>>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
> > > >>>>>>>>>>
> > > >>>>>>>>>> …the docs provide a description of each step.
> > > >>>>>>>>>>
> > > >>>>>>>>>> http://tinkerpop.incubator.apache.org/docs/3.0.0-
> > > >>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct clicking to any
> > > >>>> particular
> > > >>>>>>>>>> step)
> > > >>>>>>>>>>
> > > >>>>>>>>>> I would say that would be more helpful now than a "Through
> the
> > > >>>>>>>>>> TinkerPop"-tutorial.
> > > >>>>>>>>>>
> > > >>>>>>>>>> Finally, what else would be helpful --- more test cases. If
> > you
> > > >>> are
> > > >>>>>>>>>> interested in testing, I can get your set up in with "a
> > pattern"
> > > >>> so
> > > >>>>>>>>>> you pop
> > > >>>>>>>>>> out more process/ tests. For example:
> > > >>>>>>>>>>
> > > >>>>>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
> > > >>>>>>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
> > > >>>>>>>>>> gremlin/process/traversal/step/map/CountTest.java
> > > >>>>>>>>>>
> > > >>>>>>>>>> Thanks,
> > > >>>>>>>>>> Marko.
> > > >>>>>>>>>>
> > > >>>>>>>>>> http://markorodriguez.com
> > > >>>>>>>>>>
> > > >>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <
> > > >>> okrammarko@gmail.com>
> > > >>>>>>>>>> wrote:
> > > >>>>>>>>>>
> > > >>>>>>>>>> Hi Christos,
> > > >>>>>>>>>>
> > > >>>>>>>>>>>
> > > >>>>>>>>>>> Are you interested in writing code or perhaps, writing a
> > > >>> tutorial?
> > > >>>>>>>>>>>
> > > >>>>>>>>>>> It would be nice to have an in-depth tutorial on
> TinkerPop3.
> > > >> For
> > > >>>>>>>>>>> instance, find a reasonably sized dataset (<1 million
> edges),
> > > >>> parse
> > > >>>>>>>>>>> it into
> > > >>>>>>>>>>> a graph, do some analysis on it, expose it via Gremlin
> > Server,
> > > >>> OLTP
> > > >>>>>>>>>>> and
> > > >>>>>>>>>>> OLAP queries hitting it, etc. Write up the path you took
> into
> > > >> an
> > > >>>>>>>>>>> AsciiDoc
> > > >>>>>>>>>>> and we could put it on the Apache TinkerPop site as a
> > "Through
> > > >>> the
> > > >>>>>>>>>>> TinkerPop" tutorial. Be great if you could touch on every
> > > >> aspect
> > > >>> of
> > > >>>>>>>>>>> the
> > > >>>>>>>>>>> TinkerPop framework in the tutorial.
> > > >>>>>>>>>>>
> > > >>>>>>>>>>> I would appreciate a contribution like that.
> > > >>>>>>>>>>>
> > > >>>>>>>>>>> Thanks,
> > > >>>>>>>>>>> Marko.
> > > >>>>>>>>>>>
> > > >>>>>>>>>>> http://markorodriguez.com
> > > >>>>>>>>>>>
> > > >>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
> > > >>>> m.ben.franklin@gmail.com>
> > > >>>>>>>>>>> wrote:
> > > >>>>>>>>>>>
> > > >>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen Mallette <
> > > >>>>>>>>>>> spmallette@gmail.com>
> > > >>>>>>>>>>>
> > > >>>>>>>>>>>> wrote:
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>> My suggestion would be for you to spend some time learning
> > > >>> about
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>>> TinkerPop
> > > >>>>>>>>>>>>> (reading the documentation, examining the code base,
> > perusing
> > > >>> the
> > > >>>>>>>>>>>>> Jira
> > > >>>>>>>>>>>>> issue tracker, etc.) to determine if any particular part
> of
> > > >> the
> > > >>>>>>>>>>>>> stack
> > > >>>>>>>>>>>>> interests you.
> > > >>>>>>>>>>>>>
> > > >>>>>>>>>>>>>
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>> IMO, there is no better way to get involved than to pick
> > > >>> something
> > > >>>>>>>>>>>> that
> > > >>>>>>>>>>>> needs to be worked on and provide a patch for it. I would
> > > >> look
> > > >>> at
> > > >>>>>>>>>>>> JIRA
> > > >>>>>>>>>>>> and
> > > >>>>>>>>>>>> find an issue that interests you.
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>> In doing that, you might develop your own ideas as to
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>>> where/what you think you are best suited to contribute.
> At
> > > >>> that
> > > >>>>>>>>>>>>> point
> > > >>>>>>>>>>>>> you
> > > >>>>>>>>>>>>> could post those ideas here in the mailing list for
> > feedback.
> > > >>>>>>>>>>>>>
> > > >>>>>>>>>>>>>
> > > >>>>>>>>>>>>>
> > > >>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos Oikonomou <
> > > >>>>>>>>>>>>> chrikon1994@gmail.com
> > > >>>>>>>>>>>>>
> > > >>>>>>>>>>>>>
> > > >>>>>>>>>>>>>> wrote:
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>
> > > >>>>>>>>>>>>> Hi Stephen
> > > >>>>>>>>>>>>>
> > > >>>>>>>>>>>>>> When I start I was not familiar with the project nor the
> > > >>>>>>>>>>>>>> architecture/codebase.
> > > >>>>>>>>>>>>>> But I am reading about tinkerpop and searching in the
> code
> > > >> and
> > > >>>>>>>>>>>>>> I am thinking to make some simple examples in order to
> be
> > > >> more
> > > >>>>>>>>>>>>>> familiar
> > > >>>>>>>>>>>>>> with the functionality.
> > > >>>>>>>>>>>>>> So I am not now very familiar but I try to be in the
> near
> > > >>>> future.
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>> Christos
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen Mallette <
> > > >>>>>>>>>>>>>> spmallette@gmail.com>
> > > >>>>>>>>>>>>>> wrote:
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>> Hi Christos, we appreciate your offer to contribute.
> > Could
> > > >>> you
> > > >>>>>>>>>>>>>> tell
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>> us
> > > >>>>>>>>>>>>>>> what kind of experience you have with TinkerPop so far?
> > > >> Are
> > > >>>> you
> > > >>>>>>>>>>>>>>> at
> > > >>>>>>>>>>>>>>> all
> > > >>>>>>>>>>>>>>> familiar with the architecture/codebase?
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>> Stephen
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos Oikonomou <
> > > >>>>>>>>>>>>>>> chrikon1994@gmail.com>
> > > >>>>>>>>>>>>>>> wrote:
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>> Dear Tinkerpop Development Team
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>> My name is Christos Economou.
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>> I would like to contribute in the tinkerpop3.
> > > >>>>>>>>>>>>>>>> This contribution will be a part of an assignment in
> one
> > > >> of
> > > >>> my
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>> classes.
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>
> > > >>>>>>>>>>>>>> I am in my third year of study at Athens University of
> > > >>> Economics
> > > >>>>>>>>>>>>>>>> and
> > > >>>>>>>>>>>>>>>> Business (Greece | Hellas).In this semester I attend
> in
> > > >>>> lectures
> > > >>>>>>>>>>>>>>>> that
> > > >>>>>>>>>>>>>>>> called "Advanced Topics in Software Engineering" by
> > > >>> professor
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>> Diomidis
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>> Spinellis.
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>> As assignment I have to contribute in an open source
> > > >>> project.
> > > >>>> I
> > > >>>>>>>>>>>>>>>> would
> > > >>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3. More specifically
> I
> > > >>>>>>>>>>>>>>>> understand
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>> that
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>> in
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>> big projects, like this, always exists work on
> > integration
> > > >>> and
> > > >>>>>>>>>>>>>>>> collaboration between components and subsystems. So I
> do
> > > >> not
> > > >>>> have
> > > >>>>>>>>>>>>>>>> any
> > > >>>>>>>>>>>>>>>> problem to work on that. But I am more interested in
> > > >>> creative
> > > >>>>>>>>>>>>>>>> work
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>> like
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>> implementation of some algorithm or on a new
> functionality.
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>> I have to mention I have a hard constraint, that my
> > > >>>> contribution
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>> should
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>> be
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>> at least 100 - 200 lines of code.
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>> So I am writing you to ask if you have in mind some
> > > >>>>>>>>>>>>>>>> functionalities
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>> that
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>> I
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>> can help in development. Here some information about my
> > > >>>>>>>>>>>>>>>> knowledge in
> > > >>>>>>>>>>>>>>>> software engineering and programming languages
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>>
> http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>> inetpub/detfolio/.
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>> Thank you for your time and attention.
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>> Regards,
> > > >>>>>>>>>>>>>>>> Christos Oikonomou
> > > >>>>>>>>>>>>>>>> Assistant researcher at ISTLab
> > > >>>>>>>>>>>>>>>>
> > http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
> > > >>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>>
> > > >>>>>>>>>>>>>
> > > >>>>>>>>>>>
> > > >>>>>>>>>>
> > > >>>>>>>>>>
> > > >>>>>>>>
> > > >>>>>>
> > > >>>>
> > > >>>>
> > > >>>
> > > >>
> > >
> > >
> >
>
Re: Contributing to tinkerpop3
Posted by Matt Frantz <ma...@gmail.com>.
Perhaps there should be a command to import the javadocs for a particular
package or interface, e.g. a DSL interface. The effect would be to haul
the methods into the global doc namespace. By default, we would apply that
to GraphTraversal.
gremlin> :doc outE
TODO: Write a good javadoc for each GraphTraversal method
gremlin> :importdoc TinkerFactory.SocialTraversal
gremlin> :doc people
TODO: Write a good javadoc for each SocialTraversal method
It could be applied to any class or interface. Applying it to a package
would haul the classes and subpackages into the global doc namespace.
gremlin> :importdoc org.apache.tinkerpop.gremlin.tinkergraph.structure
gremlin> :doc TinkerHelper
gremlin> :doc TinkerHelper.queryVertexIndex
Maybe you could allow fully-qualified resolution without an import:
gremlin> :doc
org.apache.tinkerpop.gremlin.tinkergraph.structure.TinkerHelper.queryVertexIndex
This seems like something that could be contributed upstream to the Groovy
REPL.
On Fri, Apr 24, 2015 at 12:10 PM, Stephen Mallette <sp...@gmail.com>
wrote:
> Yeah - it would be straightforward to bring in javadoc for the most part:
>
> gremlin> :doc EdgeVertexStep
>
> you can get the class from that and full package name with reflection then
> translate it to javadoc to extract some text to display in the console. I
> guess that's nice, but no one knows VertexStep. They know this step
> though:
>
> gremlin> :doc outE
>
> So - I guess the question is how one would go from just a pure javadoc
> lookup command (cool but a bit less useful to a first time user who doesn't
> know the classes - not that EdgeVertexStep would yield anything about outE
> for that matter as it sits) to something that gives the user content on
> steps from GraphTraversal which is the core of the DSL. And then - how
> would it extend to other DSLs so that it was generally applicable to those
> extending the language.
>
>
>
> On Fri, Apr 24, 2015 at 3:02 PM, Marko Rodriguez <ok...@gmail.com>
> wrote:
>
> > That would be really classy. It would be cool if that could be read from
> > the JavaDoc somehow………… then we kill two birds with one stone.
> >
> > Marko.
> >
> > http://markorodriguez.com
> >
> > On Apr 24, 2015, at 12:08 PM, Stephen Mallette <sp...@gmail.com>
> > wrote:
> >
> > >> A gremlin-command that display in gremlin-console user documentation
> or
> > > javadocs of a gremlin functionality could be something that helps user?
> > >
> > > That's an interesting idea. I assume you are suggesting something
> like:
> > >
> > > gremlin> :doc choose
> > > ==>The choose()-step (branch) routes the current traverser to a
> > particular
> > > traversal branch option. With choose(), it is possible to
> implement......
> > >
> > > Is that what you mean?
> > >
> > >
> > >
> > >
> > > On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <
> > chrikon1994@gmail.com>
> > > wrote:
> > >
> > >> Hello and sorry for the delay. Thanks for the answers.
> > >> I have done a general overview of all the code base. But more
> > familiarized
> > >> I am in gremlin-core and gremlin-console.
> > >> I prefer the assignment of issues because I wants to help also to the
> > >> faster achievement of the project planning in general.
> > >> Also I have an idea in documentation. A gremlin-command that display
> in
> > >> gremlin-console user documentation or javadocs of a gremlin
> > functionality
> > >> could be something that helps user?
> > >>
> > >> Regards,
> > >> Christos
> > >>
> > >> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <
> > m.ben.franklin@gmail.com>
> > >> wrote:
> > >>
> > >>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <
> okrammarko@gmail.com>
> > >>> wrote:
> > >>>
> > >>>> Hi Christos,
> > >>>>
> > >>>> Given that you have familiarized yourself with the codebase, which
> > area
> > >>> of
> > >>>> the codebase do you feel:
> > >>>>
> > >>>> 1. you understand the best, and
> > >>>> 2. are interested in working on.
> > >>>>
> > >>>> Given that information, I will be able to figure out something
> > >> particular
> > >>>> for you to do.
> > >>>>
> > >>>
> > >>> You should also feel free to pick an issue off of JIRA yourself, or
> > even
> > >>> create an issue and submit a patch for it.
> > >>>
> > >>>
> > >>>>
> > >>>> Thanks,
> > >>>> Marko.
> > >>>>
> > >>>> http://markorodriguez.com
> > >>>>
> > >>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
> > >> chrikon1994@gmail.com>
> > >>>> wrote:
> > >>>>
> > >>>>> Hello everyone,
> > >>>>>
> > >>>>> I have read your advices how to start and how to be familiarized
> with
> > >>> the
> > >>>>> codebase. After some time I spent exploring the code, I believe I
> am
> > >>>> ready
> > >>>>> to start specific changes in the code.
> > >>>>>
> > >>>>> So am sending this message to ask you, if some of you have ideas
> > >> about
> > >>>>> features or improvement and you want one more for help.
> > >>>>>
> > >>>>> Also if you have some issues you want some help please let me know
> > >>> (jira
> > >>>>> account chrikon).
> > >>>>>
> > >>>>> Thanks in advance,
> > >>>>>
> > >>>>> Regards
> > >>>>> Christos
> > >>>>>
> > >>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <
> > >>>> chrikon1994@gmail.com>
> > >>>>> wrote:
> > >>>>>
> > >>>>>> Sorry Hadrian thank you for your correction, this will not happen
> > >>> again!
> > >>>>>>
> > >>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <
> > >> hzbarcea@gmail.com>
> > >>>>>> wrote:
> > >>>>>>
> > >>>>>>> Hi Christos,
> > >>>>>>>
> > >>>>>>> First off, I am not a Mister :), just Hadrian.
> > >>>>>>>
> > >>>>>>> Yes, the idea is to collaborate, that's what open source is
> about.
> > >>>>>>>
> > >>>>>>> Good luck,
> > >>>>>>> Hadrian
> > >>>>>>>
> > >>>>>>>
> > >>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
> > >>>>>>>
> > >>>>>>>> Firstly thank you all for your suggestions, all of them are very
> > >>>> helpful.
> > >>>>>>>>
> > >>>>>>>> In this moment I follow the very good advice and I am reading
> > >>>>>>>> documentation, because next Wednesday I have to make a
> > >> presentation
> > >>>> for
> > >>>>>>>> tinkerpop in front of my class!
> > >>>>>>>>
> > >>>>>>>> Marko I have to write code for my assignment, but in my free
> time
> > >> it
> > >>>> is
> > >>>>>>>> an
> > >>>>>>>> interesting work.
> > >>>>>>>>
> > >>>>>>>> Although Javadoc it is applicable to my assignment, I think. I
> > >> will
> > >>>> ask
> > >>>>>>>> and
> > >>>>>>>> I will have news.
> > >>>>>>>>
> > >>>>>>>> If Mr. Hadrian Zbarcea are working on it, I would like not to
> > >>>> interfere
> > >>>>>>>> in
> > >>>>>>>> your job, or we can cooperate.
> > >>>>>>>> Before that discussion I have to contact to my academic
> supervisor
> > >>> in
> > >>>>>>>> order
> > >>>>>>>> to be 100% sure that this is ok.
> > >>>>>>>>
> > >>>>>>>> P.S. I hope my English is at least understandable, if not so
> > >> please
> > >>>> ask
> > >>>>>>>> me
> > >>>>>>>> again.
> > >>>>>>>>
> > >>>>>>>> Thank you all.
> > >>>>>>>> Christos
> > >>>>>>>>
> > >>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <
> > >>> hzbarcea@gmail.com>
> > >>>>>>>> wrote:
> > >>>>>>>>
> > >>>>>>>> That's something I am interested in too.
> > >>>>>>>>> Hadrian
> > >>>>>>>>>
> > >>>>>>>>>
> > >>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
> > >>>>>>>>>
> > >>>>>>>>> Hi Christos,
> > >>>>>>>>>>
> > >>>>>>>>>> Another thing that we need is more JavaDoc! Its not sexy, but
> > >> boy
> > >>>> would
> > >>>>>>>>>> be it be great to have someone go through and JavaDoc-up
> > >>>> GraphTraversal
> > >>>>>>>>>> (all those methods…).
> > >>>>>>>>>>
> > >>>>>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
> > >>>>>>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
> > >>>>>>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
> > >>>>>>>>>>
> > >>>>>>>>>> …the docs provide a description of each step.
> > >>>>>>>>>>
> > >>>>>>>>>> http://tinkerpop.incubator.apache.org/docs/3.0.0-
> > >>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct clicking to any
> > >>>> particular
> > >>>>>>>>>> step)
> > >>>>>>>>>>
> > >>>>>>>>>> I would say that would be more helpful now than a "Through the
> > >>>>>>>>>> TinkerPop"-tutorial.
> > >>>>>>>>>>
> > >>>>>>>>>> Finally, what else would be helpful --- more test cases. If
> you
> > >>> are
> > >>>>>>>>>> interested in testing, I can get your set up in with "a
> pattern"
> > >>> so
> > >>>>>>>>>> you pop
> > >>>>>>>>>> out more process/ tests. For example:
> > >>>>>>>>>>
> > >>>>>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
> > >>>>>>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
> > >>>>>>>>>> gremlin/process/traversal/step/map/CountTest.java
> > >>>>>>>>>>
> > >>>>>>>>>> Thanks,
> > >>>>>>>>>> Marko.
> > >>>>>>>>>>
> > >>>>>>>>>> http://markorodriguez.com
> > >>>>>>>>>>
> > >>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <
> > >>> okrammarko@gmail.com>
> > >>>>>>>>>> wrote:
> > >>>>>>>>>>
> > >>>>>>>>>> Hi Christos,
> > >>>>>>>>>>
> > >>>>>>>>>>>
> > >>>>>>>>>>> Are you interested in writing code or perhaps, writing a
> > >>> tutorial?
> > >>>>>>>>>>>
> > >>>>>>>>>>> It would be nice to have an in-depth tutorial on TinkerPop3.
> > >> For
> > >>>>>>>>>>> instance, find a reasonably sized dataset (<1 million edges),
> > >>> parse
> > >>>>>>>>>>> it into
> > >>>>>>>>>>> a graph, do some analysis on it, expose it via Gremlin
> Server,
> > >>> OLTP
> > >>>>>>>>>>> and
> > >>>>>>>>>>> OLAP queries hitting it, etc. Write up the path you took into
> > >> an
> > >>>>>>>>>>> AsciiDoc
> > >>>>>>>>>>> and we could put it on the Apache TinkerPop site as a
> "Through
> > >>> the
> > >>>>>>>>>>> TinkerPop" tutorial. Be great if you could touch on every
> > >> aspect
> > >>> of
> > >>>>>>>>>>> the
> > >>>>>>>>>>> TinkerPop framework in the tutorial.
> > >>>>>>>>>>>
> > >>>>>>>>>>> I would appreciate a contribution like that.
> > >>>>>>>>>>>
> > >>>>>>>>>>> Thanks,
> > >>>>>>>>>>> Marko.
> > >>>>>>>>>>>
> > >>>>>>>>>>> http://markorodriguez.com
> > >>>>>>>>>>>
> > >>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
> > >>>> m.ben.franklin@gmail.com>
> > >>>>>>>>>>> wrote:
> > >>>>>>>>>>>
> > >>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen Mallette <
> > >>>>>>>>>>> spmallette@gmail.com>
> > >>>>>>>>>>>
> > >>>>>>>>>>>> wrote:
> > >>>>>>>>>>>>
> > >>>>>>>>>>>> My suggestion would be for you to spend some time learning
> > >>> about
> > >>>>>>>>>>>>
> > >>>>>>>>>>>>> TinkerPop
> > >>>>>>>>>>>>> (reading the documentation, examining the code base,
> perusing
> > >>> the
> > >>>>>>>>>>>>> Jira
> > >>>>>>>>>>>>> issue tracker, etc.) to determine if any particular part of
> > >> the
> > >>>>>>>>>>>>> stack
> > >>>>>>>>>>>>> interests you.
> > >>>>>>>>>>>>>
> > >>>>>>>>>>>>>
> > >>>>>>>>>>>>
> > >>>>>>>>>>>> IMO, there is no better way to get involved than to pick
> > >>> something
> > >>>>>>>>>>>> that
> > >>>>>>>>>>>> needs to be worked on and provide a patch for it. I would
> > >> look
> > >>> at
> > >>>>>>>>>>>> JIRA
> > >>>>>>>>>>>> and
> > >>>>>>>>>>>> find an issue that interests you.
> > >>>>>>>>>>>>
> > >>>>>>>>>>>>
> > >>>>>>>>>>>> In doing that, you might develop your own ideas as to
> > >>>>>>>>>>>>
> > >>>>>>>>>>>>> where/what you think you are best suited to contribute. At
> > >>> that
> > >>>>>>>>>>>>> point
> > >>>>>>>>>>>>> you
> > >>>>>>>>>>>>> could post those ideas here in the mailing list for
> feedback.
> > >>>>>>>>>>>>>
> > >>>>>>>>>>>>>
> > >>>>>>>>>>>>>
> > >>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos Oikonomou <
> > >>>>>>>>>>>>> chrikon1994@gmail.com
> > >>>>>>>>>>>>>
> > >>>>>>>>>>>>>
> > >>>>>>>>>>>>>> wrote:
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>>
> > >>>>>>>>>>>>> Hi Stephen
> > >>>>>>>>>>>>>
> > >>>>>>>>>>>>>> When I start I was not familiar with the project nor the
> > >>>>>>>>>>>>>> architecture/codebase.
> > >>>>>>>>>>>>>> But I am reading about tinkerpop and searching in the code
> > >> and
> > >>>>>>>>>>>>>> I am thinking to make some simple examples in order to be
> > >> more
> > >>>>>>>>>>>>>> familiar
> > >>>>>>>>>>>>>> with the functionality.
> > >>>>>>>>>>>>>> So I am not now very familiar but I try to be in the near
> > >>>> future.
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>>> Christos
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen Mallette <
> > >>>>>>>>>>>>>> spmallette@gmail.com>
> > >>>>>>>>>>>>>> wrote:
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>>> Hi Christos, we appreciate your offer to contribute.
> Could
> > >>> you
> > >>>>>>>>>>>>>> tell
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>> us
> > >>>>>>>>>>>>>>> what kind of experience you have with TinkerPop so far?
> > >> Are
> > >>>> you
> > >>>>>>>>>>>>>>> at
> > >>>>>>>>>>>>>>> all
> > >>>>>>>>>>>>>>> familiar with the architecture/codebase?
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>> Stephen
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos Oikonomou <
> > >>>>>>>>>>>>>>> chrikon1994@gmail.com>
> > >>>>>>>>>>>>>>> wrote:
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>> Dear Tinkerpop Development Team
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>> My name is Christos Economou.
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>> I would like to contribute in the tinkerpop3.
> > >>>>>>>>>>>>>>>> This contribution will be a part of an assignment in one
> > >> of
> > >>> my
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>> classes.
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>>
> > >>>>>>>>>>>>>> I am in my third year of study at Athens University of
> > >>> Economics
> > >>>>>>>>>>>>>>>> and
> > >>>>>>>>>>>>>>>> Business (Greece | Hellas).In this semester I attend in
> > >>>> lectures
> > >>>>>>>>>>>>>>>> that
> > >>>>>>>>>>>>>>>> called "Advanced Topics in Software Engineering" by
> > >>> professor
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>> Diomidis
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>> Spinellis.
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>> As assignment I have to contribute in an open source
> > >>> project.
> > >>>> I
> > >>>>>>>>>>>>>>>> would
> > >>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3. More specifically I
> > >>>>>>>>>>>>>>>> understand
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>> that
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>> in
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>> big projects, like this, always exists work on
> integration
> > >>> and
> > >>>>>>>>>>>>>>>> collaboration between components and subsystems. So I do
> > >> not
> > >>>> have
> > >>>>>>>>>>>>>>>> any
> > >>>>>>>>>>>>>>>> problem to work on that. But I am more interested in
> > >>> creative
> > >>>>>>>>>>>>>>>> work
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>> like
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>> implementation of some algorithm or on a new functionality.
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>> I have to mention I have a hard constraint, that my
> > >>>> contribution
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>> should
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>> be
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>> at least 100 - 200 lines of code.
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>> So I am writing you to ask if you have in mind some
> > >>>>>>>>>>>>>>>> functionalities
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>> that
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>>> I
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>> can help in development. Here some information about my
> > >>>>>>>>>>>>>>>> knowledge in
> > >>>>>>>>>>>>>>>> software engineering and programming languages
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>> http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>> inetpub/detfolio/.
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>> Thank you for your time and attention.
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>> Regards,
> > >>>>>>>>>>>>>>>> Christos Oikonomou
> > >>>>>>>>>>>>>>>> Assistant researcher at ISTLab
> > >>>>>>>>>>>>>>>>
> http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
> > >>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>>
> > >>>>>>>>>>>>>>
> > >>>>>>>>>>>>>
> > >>>>>>>>>>>
> > >>>>>>>>>>
> > >>>>>>>>>>
> > >>>>>>>>
> > >>>>>>
> > >>>>
> > >>>>
> > >>>
> > >>
> >
> >
>
Re: Contributing to tinkerpop3
Posted by Stephen Mallette <sp...@gmail.com>.
Yeah - it would be straightforward to bring in javadoc for the most part:
gremlin> :doc EdgeVertexStep
you can get the class from that and full package name with reflection then
translate it to javadoc to extract some text to display in the console. I
guess that's nice, but no one knows VertexStep. They know this step though:
gremlin> :doc outE
So - I guess the question is how one would go from just a pure javadoc
lookup command (cool but a bit less useful to a first time user who doesn't
know the classes - not that EdgeVertexStep would yield anything about outE
for that matter as it sits) to something that gives the user content on
steps from GraphTraversal which is the core of the DSL. And then - how
would it extend to other DSLs so that it was generally applicable to those
extending the language.
On Fri, Apr 24, 2015 at 3:02 PM, Marko Rodriguez <ok...@gmail.com>
wrote:
> That would be really classy. It would be cool if that could be read from
> the JavaDoc somehow………… then we kill two birds with one stone.
>
> Marko.
>
> http://markorodriguez.com
>
> On Apr 24, 2015, at 12:08 PM, Stephen Mallette <sp...@gmail.com>
> wrote:
>
> >> A gremlin-command that display in gremlin-console user documentation or
> > javadocs of a gremlin functionality could be something that helps user?
> >
> > That's an interesting idea. I assume you are suggesting something like:
> >
> > gremlin> :doc choose
> > ==>The choose()-step (branch) routes the current traverser to a
> particular
> > traversal branch option. With choose(), it is possible to implement......
> >
> > Is that what you mean?
> >
> >
> >
> >
> > On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <
> chrikon1994@gmail.com>
> > wrote:
> >
> >> Hello and sorry for the delay. Thanks for the answers.
> >> I have done a general overview of all the code base. But more
> familiarized
> >> I am in gremlin-core and gremlin-console.
> >> I prefer the assignment of issues because I wants to help also to the
> >> faster achievement of the project planning in general.
> >> Also I have an idea in documentation. A gremlin-command that display in
> >> gremlin-console user documentation or javadocs of a gremlin
> functionality
> >> could be something that helps user?
> >>
> >> Regards,
> >> Christos
> >>
> >> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <
> m.ben.franklin@gmail.com>
> >> wrote:
> >>
> >>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <ok...@gmail.com>
> >>> wrote:
> >>>
> >>>> Hi Christos,
> >>>>
> >>>> Given that you have familiarized yourself with the codebase, which
> area
> >>> of
> >>>> the codebase do you feel:
> >>>>
> >>>> 1. you understand the best, and
> >>>> 2. are interested in working on.
> >>>>
> >>>> Given that information, I will be able to figure out something
> >> particular
> >>>> for you to do.
> >>>>
> >>>
> >>> You should also feel free to pick an issue off of JIRA yourself, or
> even
> >>> create an issue and submit a patch for it.
> >>>
> >>>
> >>>>
> >>>> Thanks,
> >>>> Marko.
> >>>>
> >>>> http://markorodriguez.com
> >>>>
> >>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
> >> chrikon1994@gmail.com>
> >>>> wrote:
> >>>>
> >>>>> Hello everyone,
> >>>>>
> >>>>> I have read your advices how to start and how to be familiarized with
> >>> the
> >>>>> codebase. After some time I spent exploring the code, I believe I am
> >>>> ready
> >>>>> to start specific changes in the code.
> >>>>>
> >>>>> So am sending this message to ask you, if some of you have ideas
> >> about
> >>>>> features or improvement and you want one more for help.
> >>>>>
> >>>>> Also if you have some issues you want some help please let me know
> >>> (jira
> >>>>> account chrikon).
> >>>>>
> >>>>> Thanks in advance,
> >>>>>
> >>>>> Regards
> >>>>> Christos
> >>>>>
> >>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <
> >>>> chrikon1994@gmail.com>
> >>>>> wrote:
> >>>>>
> >>>>>> Sorry Hadrian thank you for your correction, this will not happen
> >>> again!
> >>>>>>
> >>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <
> >> hzbarcea@gmail.com>
> >>>>>> wrote:
> >>>>>>
> >>>>>>> Hi Christos,
> >>>>>>>
> >>>>>>> First off, I am not a Mister :), just Hadrian.
> >>>>>>>
> >>>>>>> Yes, the idea is to collaborate, that's what open source is about.
> >>>>>>>
> >>>>>>> Good luck,
> >>>>>>> Hadrian
> >>>>>>>
> >>>>>>>
> >>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
> >>>>>>>
> >>>>>>>> Firstly thank you all for your suggestions, all of them are very
> >>>> helpful.
> >>>>>>>>
> >>>>>>>> In this moment I follow the very good advice and I am reading
> >>>>>>>> documentation, because next Wednesday I have to make a
> >> presentation
> >>>> for
> >>>>>>>> tinkerpop in front of my class!
> >>>>>>>>
> >>>>>>>> Marko I have to write code for my assignment, but in my free time
> >> it
> >>>> is
> >>>>>>>> an
> >>>>>>>> interesting work.
> >>>>>>>>
> >>>>>>>> Although Javadoc it is applicable to my assignment, I think. I
> >> will
> >>>> ask
> >>>>>>>> and
> >>>>>>>> I will have news.
> >>>>>>>>
> >>>>>>>> If Mr. Hadrian Zbarcea are working on it, I would like not to
> >>>> interfere
> >>>>>>>> in
> >>>>>>>> your job, or we can cooperate.
> >>>>>>>> Before that discussion I have to contact to my academic supervisor
> >>> in
> >>>>>>>> order
> >>>>>>>> to be 100% sure that this is ok.
> >>>>>>>>
> >>>>>>>> P.S. I hope my English is at least understandable, if not so
> >> please
> >>>> ask
> >>>>>>>> me
> >>>>>>>> again.
> >>>>>>>>
> >>>>>>>> Thank you all.
> >>>>>>>> Christos
> >>>>>>>>
> >>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <
> >>> hzbarcea@gmail.com>
> >>>>>>>> wrote:
> >>>>>>>>
> >>>>>>>> That's something I am interested in too.
> >>>>>>>>> Hadrian
> >>>>>>>>>
> >>>>>>>>>
> >>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
> >>>>>>>>>
> >>>>>>>>> Hi Christos,
> >>>>>>>>>>
> >>>>>>>>>> Another thing that we need is more JavaDoc! Its not sexy, but
> >> boy
> >>>> would
> >>>>>>>>>> be it be great to have someone go through and JavaDoc-up
> >>>> GraphTraversal
> >>>>>>>>>> (all those methods…).
> >>>>>>>>>>
> >>>>>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
> >>>>>>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
> >>>>>>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
> >>>>>>>>>>
> >>>>>>>>>> …the docs provide a description of each step.
> >>>>>>>>>>
> >>>>>>>>>> http://tinkerpop.incubator.apache.org/docs/3.0.0-
> >>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct clicking to any
> >>>> particular
> >>>>>>>>>> step)
> >>>>>>>>>>
> >>>>>>>>>> I would say that would be more helpful now than a "Through the
> >>>>>>>>>> TinkerPop"-tutorial.
> >>>>>>>>>>
> >>>>>>>>>> Finally, what else would be helpful --- more test cases. If you
> >>> are
> >>>>>>>>>> interested in testing, I can get your set up in with "a pattern"
> >>> so
> >>>>>>>>>> you pop
> >>>>>>>>>> out more process/ tests. For example:
> >>>>>>>>>>
> >>>>>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
> >>>>>>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
> >>>>>>>>>> gremlin/process/traversal/step/map/CountTest.java
> >>>>>>>>>>
> >>>>>>>>>> Thanks,
> >>>>>>>>>> Marko.
> >>>>>>>>>>
> >>>>>>>>>> http://markorodriguez.com
> >>>>>>>>>>
> >>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <
> >>> okrammarko@gmail.com>
> >>>>>>>>>> wrote:
> >>>>>>>>>>
> >>>>>>>>>> Hi Christos,
> >>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>> Are you interested in writing code or perhaps, writing a
> >>> tutorial?
> >>>>>>>>>>>
> >>>>>>>>>>> It would be nice to have an in-depth tutorial on TinkerPop3.
> >> For
> >>>>>>>>>>> instance, find a reasonably sized dataset (<1 million edges),
> >>> parse
> >>>>>>>>>>> it into
> >>>>>>>>>>> a graph, do some analysis on it, expose it via Gremlin Server,
> >>> OLTP
> >>>>>>>>>>> and
> >>>>>>>>>>> OLAP queries hitting it, etc. Write up the path you took into
> >> an
> >>>>>>>>>>> AsciiDoc
> >>>>>>>>>>> and we could put it on the Apache TinkerPop site as a "Through
> >>> the
> >>>>>>>>>>> TinkerPop" tutorial. Be great if you could touch on every
> >> aspect
> >>> of
> >>>>>>>>>>> the
> >>>>>>>>>>> TinkerPop framework in the tutorial.
> >>>>>>>>>>>
> >>>>>>>>>>> I would appreciate a contribution like that.
> >>>>>>>>>>>
> >>>>>>>>>>> Thanks,
> >>>>>>>>>>> Marko.
> >>>>>>>>>>>
> >>>>>>>>>>> http://markorodriguez.com
> >>>>>>>>>>>
> >>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
> >>>> m.ben.franklin@gmail.com>
> >>>>>>>>>>> wrote:
> >>>>>>>>>>>
> >>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen Mallette <
> >>>>>>>>>>> spmallette@gmail.com>
> >>>>>>>>>>>
> >>>>>>>>>>>> wrote:
> >>>>>>>>>>>>
> >>>>>>>>>>>> My suggestion would be for you to spend some time learning
> >>> about
> >>>>>>>>>>>>
> >>>>>>>>>>>>> TinkerPop
> >>>>>>>>>>>>> (reading the documentation, examining the code base, perusing
> >>> the
> >>>>>>>>>>>>> Jira
> >>>>>>>>>>>>> issue tracker, etc.) to determine if any particular part of
> >> the
> >>>>>>>>>>>>> stack
> >>>>>>>>>>>>> interests you.
> >>>>>>>>>>>>>
> >>>>>>>>>>>>>
> >>>>>>>>>>>>
> >>>>>>>>>>>> IMO, there is no better way to get involved than to pick
> >>> something
> >>>>>>>>>>>> that
> >>>>>>>>>>>> needs to be worked on and provide a patch for it. I would
> >> look
> >>> at
> >>>>>>>>>>>> JIRA
> >>>>>>>>>>>> and
> >>>>>>>>>>>> find an issue that interests you.
> >>>>>>>>>>>>
> >>>>>>>>>>>>
> >>>>>>>>>>>> In doing that, you might develop your own ideas as to
> >>>>>>>>>>>>
> >>>>>>>>>>>>> where/what you think you are best suited to contribute. At
> >>> that
> >>>>>>>>>>>>> point
> >>>>>>>>>>>>> you
> >>>>>>>>>>>>> could post those ideas here in the mailing list for feedback.
> >>>>>>>>>>>>>
> >>>>>>>>>>>>>
> >>>>>>>>>>>>>
> >>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos Oikonomou <
> >>>>>>>>>>>>> chrikon1994@gmail.com
> >>>>>>>>>>>>>
> >>>>>>>>>>>>>
> >>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>
> >>>>>>>>>>>>> Hi Stephen
> >>>>>>>>>>>>>
> >>>>>>>>>>>>>> When I start I was not familiar with the project nor the
> >>>>>>>>>>>>>> architecture/codebase.
> >>>>>>>>>>>>>> But I am reading about tinkerpop and searching in the code
> >> and
> >>>>>>>>>>>>>> I am thinking to make some simple examples in order to be
> >> more
> >>>>>>>>>>>>>> familiar
> >>>>>>>>>>>>>> with the functionality.
> >>>>>>>>>>>>>> So I am not now very familiar but I try to be in the near
> >>>> future.
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>> Christos
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen Mallette <
> >>>>>>>>>>>>>> spmallette@gmail.com>
> >>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>> Hi Christos, we appreciate your offer to contribute. Could
> >>> you
> >>>>>>>>>>>>>> tell
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> us
> >>>>>>>>>>>>>>> what kind of experience you have with TinkerPop so far?
> >> Are
> >>>> you
> >>>>>>>>>>>>>>> at
> >>>>>>>>>>>>>>> all
> >>>>>>>>>>>>>>> familiar with the architecture/codebase?
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> Stephen
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos Oikonomou <
> >>>>>>>>>>>>>>> chrikon1994@gmail.com>
> >>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> Dear Tinkerpop Development Team
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> My name is Christos Economou.
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> I would like to contribute in the tinkerpop3.
> >>>>>>>>>>>>>>>> This contribution will be a part of an assignment in one
> >> of
> >>> my
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> classes.
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>
> >>>>>>>>>>>>>> I am in my third year of study at Athens University of
> >>> Economics
> >>>>>>>>>>>>>>>> and
> >>>>>>>>>>>>>>>> Business (Greece | Hellas).In this semester I attend in
> >>>> lectures
> >>>>>>>>>>>>>>>> that
> >>>>>>>>>>>>>>>> called "Advanced Topics in Software Engineering" by
> >>> professor
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> Diomidis
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>> Spinellis.
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> As assignment I have to contribute in an open source
> >>> project.
> >>>> I
> >>>>>>>>>>>>>>>> would
> >>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3. More specifically I
> >>>>>>>>>>>>>>>> understand
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> that
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>> in
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> big projects, like this, always exists work on integration
> >>> and
> >>>>>>>>>>>>>>>> collaboration between components and subsystems. So I do
> >> not
> >>>> have
> >>>>>>>>>>>>>>>> any
> >>>>>>>>>>>>>>>> problem to work on that. But I am more interested in
> >>> creative
> >>>>>>>>>>>>>>>> work
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> like
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>> implementation of some algorithm or on a new functionality.
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> I have to mention I have a hard constraint, that my
> >>>> contribution
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> should
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>> be
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> at least 100 - 200 lines of code.
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> So I am writing you to ask if you have in mind some
> >>>>>>>>>>>>>>>> functionalities
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> that
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>> I
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> can help in development. Here some information about my
> >>>>>>>>>>>>>>>> knowledge in
> >>>>>>>>>>>>>>>> software engineering and programming languages
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> inetpub/detfolio/.
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> Thank you for your time and attention.
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> Regards,
> >>>>>>>>>>>>>>>> Christos Oikonomou
> >>>>>>>>>>>>>>>> Assistant researcher at ISTLab
> >>>>>>>>>>>>>>>> http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
> >>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>
> >>>>>>
> >>>>
> >>>>
> >>>
> >>
>
>
Re: Contributing to tinkerpop3
Posted by Marko Rodriguez <ok...@gmail.com>.
That would be really classy. It would be cool if that could be read from the JavaDoc somehow………… then we kill two birds with one stone.
Marko.
http://markorodriguez.com
On Apr 24, 2015, at 12:08 PM, Stephen Mallette <sp...@gmail.com> wrote:
>> A gremlin-command that display in gremlin-console user documentation or
> javadocs of a gremlin functionality could be something that helps user?
>
> That's an interesting idea. I assume you are suggesting something like:
>
> gremlin> :doc choose
> ==>The choose()-step (branch) routes the current traverser to a particular
> traversal branch option. With choose(), it is possible to implement......
>
> Is that what you mean?
>
>
>
>
> On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <ch...@gmail.com>
> wrote:
>
>> Hello and sorry for the delay. Thanks for the answers.
>> I have done a general overview of all the code base. But more familiarized
>> I am in gremlin-core and gremlin-console.
>> I prefer the assignment of issues because I wants to help also to the
>> faster achievement of the project planning in general.
>> Also I have an idea in documentation. A gremlin-command that display in
>> gremlin-console user documentation or javadocs of a gremlin functionality
>> could be something that helps user?
>>
>> Regards,
>> Christos
>>
>> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <m....@gmail.com>
>> wrote:
>>
>>> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <ok...@gmail.com>
>>> wrote:
>>>
>>>> Hi Christos,
>>>>
>>>> Given that you have familiarized yourself with the codebase, which area
>>> of
>>>> the codebase do you feel:
>>>>
>>>> 1. you understand the best, and
>>>> 2. are interested in working on.
>>>>
>>>> Given that information, I will be able to figure out something
>> particular
>>>> for you to do.
>>>>
>>>
>>> You should also feel free to pick an issue off of JIRA yourself, or even
>>> create an issue and submit a patch for it.
>>>
>>>
>>>>
>>>> Thanks,
>>>> Marko.
>>>>
>>>> http://markorodriguez.com
>>>>
>>>> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
>> chrikon1994@gmail.com>
>>>> wrote:
>>>>
>>>>> Hello everyone,
>>>>>
>>>>> I have read your advices how to start and how to be familiarized with
>>> the
>>>>> codebase. After some time I spent exploring the code, I believe I am
>>>> ready
>>>>> to start specific changes in the code.
>>>>>
>>>>> So am sending this message to ask you, if some of you have ideas
>> about
>>>>> features or improvement and you want one more for help.
>>>>>
>>>>> Also if you have some issues you want some help please let me know
>>> (jira
>>>>> account chrikon).
>>>>>
>>>>> Thanks in advance,
>>>>>
>>>>> Regards
>>>>> Christos
>>>>>
>>>>> On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <
>>>> chrikon1994@gmail.com>
>>>>> wrote:
>>>>>
>>>>>> Sorry Hadrian thank you for your correction, this will not happen
>>> again!
>>>>>>
>>>>>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <
>> hzbarcea@gmail.com>
>>>>>> wrote:
>>>>>>
>>>>>>> Hi Christos,
>>>>>>>
>>>>>>> First off, I am not a Mister :), just Hadrian.
>>>>>>>
>>>>>>> Yes, the idea is to collaborate, that's what open source is about.
>>>>>>>
>>>>>>> Good luck,
>>>>>>> Hadrian
>>>>>>>
>>>>>>>
>>>>>>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
>>>>>>>
>>>>>>>> Firstly thank you all for your suggestions, all of them are very
>>>> helpful.
>>>>>>>>
>>>>>>>> In this moment I follow the very good advice and I am reading
>>>>>>>> documentation, because next Wednesday I have to make a
>> presentation
>>>> for
>>>>>>>> tinkerpop in front of my class!
>>>>>>>>
>>>>>>>> Marko I have to write code for my assignment, but in my free time
>> it
>>>> is
>>>>>>>> an
>>>>>>>> interesting work.
>>>>>>>>
>>>>>>>> Although Javadoc it is applicable to my assignment, I think. I
>> will
>>>> ask
>>>>>>>> and
>>>>>>>> I will have news.
>>>>>>>>
>>>>>>>> If Mr. Hadrian Zbarcea are working on it, I would like not to
>>>> interfere
>>>>>>>> in
>>>>>>>> your job, or we can cooperate.
>>>>>>>> Before that discussion I have to contact to my academic supervisor
>>> in
>>>>>>>> order
>>>>>>>> to be 100% sure that this is ok.
>>>>>>>>
>>>>>>>> P.S. I hope my English is at least understandable, if not so
>> please
>>>> ask
>>>>>>>> me
>>>>>>>> again.
>>>>>>>>
>>>>>>>> Thank you all.
>>>>>>>> Christos
>>>>>>>>
>>>>>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <
>>> hzbarcea@gmail.com>
>>>>>>>> wrote:
>>>>>>>>
>>>>>>>> That's something I am interested in too.
>>>>>>>>> Hadrian
>>>>>>>>>
>>>>>>>>>
>>>>>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
>>>>>>>>>
>>>>>>>>> Hi Christos,
>>>>>>>>>>
>>>>>>>>>> Another thing that we need is more JavaDoc! Its not sexy, but
>> boy
>>>> would
>>>>>>>>>> be it be great to have someone go through and JavaDoc-up
>>>> GraphTraversal
>>>>>>>>>> (all those methods…).
>>>>>>>>>>
>>>>>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
>>>>>>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
>>>>>>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
>>>>>>>>>>
>>>>>>>>>> …the docs provide a description of each step.
>>>>>>>>>>
>>>>>>>>>> http://tinkerpop.incubator.apache.org/docs/3.0.0-
>>>>>>>>>> SNAPSHOT/#traversal (see the TOC for direct clicking to any
>>>> particular
>>>>>>>>>> step)
>>>>>>>>>>
>>>>>>>>>> I would say that would be more helpful now than a "Through the
>>>>>>>>>> TinkerPop"-tutorial.
>>>>>>>>>>
>>>>>>>>>> Finally, what else would be helpful --- more test cases. If you
>>> are
>>>>>>>>>> interested in testing, I can get your set up in with "a pattern"
>>> so
>>>>>>>>>> you pop
>>>>>>>>>> out more process/ tests. For example:
>>>>>>>>>>
>>>>>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
>>>>>>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
>>>>>>>>>> gremlin/process/traversal/step/map/CountTest.java
>>>>>>>>>>
>>>>>>>>>> Thanks,
>>>>>>>>>> Marko.
>>>>>>>>>>
>>>>>>>>>> http://markorodriguez.com
>>>>>>>>>>
>>>>>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <
>>> okrammarko@gmail.com>
>>>>>>>>>> wrote:
>>>>>>>>>>
>>>>>>>>>> Hi Christos,
>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>> Are you interested in writing code or perhaps, writing a
>>> tutorial?
>>>>>>>>>>>
>>>>>>>>>>> It would be nice to have an in-depth tutorial on TinkerPop3.
>> For
>>>>>>>>>>> instance, find a reasonably sized dataset (<1 million edges),
>>> parse
>>>>>>>>>>> it into
>>>>>>>>>>> a graph, do some analysis on it, expose it via Gremlin Server,
>>> OLTP
>>>>>>>>>>> and
>>>>>>>>>>> OLAP queries hitting it, etc. Write up the path you took into
>> an
>>>>>>>>>>> AsciiDoc
>>>>>>>>>>> and we could put it on the Apache TinkerPop site as a "Through
>>> the
>>>>>>>>>>> TinkerPop" tutorial. Be great if you could touch on every
>> aspect
>>> of
>>>>>>>>>>> the
>>>>>>>>>>> TinkerPop framework in the tutorial.
>>>>>>>>>>>
>>>>>>>>>>> I would appreciate a contribution like that.
>>>>>>>>>>>
>>>>>>>>>>> Thanks,
>>>>>>>>>>> Marko.
>>>>>>>>>>>
>>>>>>>>>>> http://markorodriguez.com
>>>>>>>>>>>
>>>>>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
>>>> m.ben.franklin@gmail.com>
>>>>>>>>>>> wrote:
>>>>>>>>>>>
>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen Mallette <
>>>>>>>>>>> spmallette@gmail.com>
>>>>>>>>>>>
>>>>>>>>>>>> wrote:
>>>>>>>>>>>>
>>>>>>>>>>>> My suggestion would be for you to spend some time learning
>>> about
>>>>>>>>>>>>
>>>>>>>>>>>>> TinkerPop
>>>>>>>>>>>>> (reading the documentation, examining the code base, perusing
>>> the
>>>>>>>>>>>>> Jira
>>>>>>>>>>>>> issue tracker, etc.) to determine if any particular part of
>> the
>>>>>>>>>>>>> stack
>>>>>>>>>>>>> interests you.
>>>>>>>>>>>>>
>>>>>>>>>>>>>
>>>>>>>>>>>>
>>>>>>>>>>>> IMO, there is no better way to get involved than to pick
>>> something
>>>>>>>>>>>> that
>>>>>>>>>>>> needs to be worked on and provide a patch for it. I would
>> look
>>> at
>>>>>>>>>>>> JIRA
>>>>>>>>>>>> and
>>>>>>>>>>>> find an issue that interests you.
>>>>>>>>>>>>
>>>>>>>>>>>>
>>>>>>>>>>>> In doing that, you might develop your own ideas as to
>>>>>>>>>>>>
>>>>>>>>>>>>> where/what you think you are best suited to contribute. At
>>> that
>>>>>>>>>>>>> point
>>>>>>>>>>>>> you
>>>>>>>>>>>>> could post those ideas here in the mailing list for feedback.
>>>>>>>>>>>>>
>>>>>>>>>>>>>
>>>>>>>>>>>>>
>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos Oikonomou <
>>>>>>>>>>>>> chrikon1994@gmail.com
>>>>>>>>>>>>>
>>>>>>>>>>>>>
>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>
>>>>>>>>>>>>>
>>>>>>>>>>>>> Hi Stephen
>>>>>>>>>>>>>
>>>>>>>>>>>>>> When I start I was not familiar with the project nor the
>>>>>>>>>>>>>> architecture/codebase.
>>>>>>>>>>>>>> But I am reading about tinkerpop and searching in the code
>> and
>>>>>>>>>>>>>> I am thinking to make some simple examples in order to be
>> more
>>>>>>>>>>>>>> familiar
>>>>>>>>>>>>>> with the functionality.
>>>>>>>>>>>>>> So I am not now very familiar but I try to be in the near
>>>> future.
>>>>>>>>>>>>>>
>>>>>>>>>>>>>> Christos
>>>>>>>>>>>>>>
>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen Mallette <
>>>>>>>>>>>>>> spmallette@gmail.com>
>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>
>>>>>>>>>>>>>> Hi Christos, we appreciate your offer to contribute. Could
>>> you
>>>>>>>>>>>>>> tell
>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> us
>>>>>>>>>>>>>>> what kind of experience you have with TinkerPop so far?
>> Are
>>>> you
>>>>>>>>>>>>>>> at
>>>>>>>>>>>>>>> all
>>>>>>>>>>>>>>> familiar with the architecture/codebase?
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> Stephen
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos Oikonomou <
>>>>>>>>>>>>>>> chrikon1994@gmail.com>
>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> Dear Tinkerpop Development Team
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> My name is Christos Economou.
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> I would like to contribute in the tinkerpop3.
>>>>>>>>>>>>>>>> This contribution will be a part of an assignment in one
>> of
>>> my
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> classes.
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>
>>>>>>>>>>>>>
>>>>>>>>>>>>>> I am in my third year of study at Athens University of
>>> Economics
>>>>>>>>>>>>>>>> and
>>>>>>>>>>>>>>>> Business (Greece | Hellas).In this semester I attend in
>>>> lectures
>>>>>>>>>>>>>>>> that
>>>>>>>>>>>>>>>> called "Advanced Topics in Software Engineering" by
>>> professor
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> Diomidis
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>
>>>>>>>>>>>>> Spinellis.
>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> As assignment I have to contribute in an open source
>>> project.
>>>> I
>>>>>>>>>>>>>>>> would
>>>>>>>>>>>>>>>> prefer to contribute to tinkerpop3. More specifically I
>>>>>>>>>>>>>>>> understand
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> that
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>
>>>>>>>>>>>>> in
>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> big projects, like this, always exists work on integration
>>> and
>>>>>>>>>>>>>>>> collaboration between components and subsystems. So I do
>> not
>>>> have
>>>>>>>>>>>>>>>> any
>>>>>>>>>>>>>>>> problem to work on that. But I am more interested in
>>> creative
>>>>>>>>>>>>>>>> work
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> like
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>
>>>>>>>>>>>>> implementation of some algorithm or on a new functionality.
>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> I have to mention I have a hard constraint, that my
>>>> contribution
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> should
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>
>>>>>>>>>>>>> be
>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> at least 100 - 200 lines of code.
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> So I am writing you to ask if you have in mind some
>>>>>>>>>>>>>>>> functionalities
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> that
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>
>>>>>>>>>>>>>> I
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> can help in development. Here some information about my
>>>>>>>>>>>>>>>> knowledge in
>>>>>>>>>>>>>>>> software engineering and programming languages
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> inetpub/detfolio/.
>>>>>>>>>>>>>>
>>>>>>>>>>>>>>
>>>>>>>>>>>>>>> Thank you for your time and attention.
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>> Regards,
>>>>>>>>>>>>>>>> Christos Oikonomou
>>>>>>>>>>>>>>>> Assistant researcher at ISTLab
>>>>>>>>>>>>>>>> http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
>>>>>>>>>>>>>>>> Github: https://github.com/xristosoik
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>
>>>>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>
>>>>>>
>>>>
>>>>
>>>
>>
Re: Contributing to tinkerpop3
Posted by Stephen Mallette <sp...@gmail.com>.
> A gremlin-command that display in gremlin-console user documentation or
javadocs of a gremlin functionality could be something that helps user?
That's an interesting idea. I assume you are suggesting something like:
gremlin> :doc choose
==>The choose()-step (branch) routes the current traverser to a particular
traversal branch option. With choose(), it is possible to implement......
Is that what you mean?
On Fri, Apr 24, 2015 at 1:13 PM, Christos Oikonomou <ch...@gmail.com>
wrote:
> Hello and sorry for the delay. Thanks for the answers.
> I have done a general overview of all the code base. But more familiarized
> I am in gremlin-core and gremlin-console.
> I prefer the assignment of issues because I wants to help also to the
> faster achievement of the project planning in general.
> Also I have an idea in documentation. A gremlin-command that display in
> gremlin-console user documentation or javadocs of a gremlin functionality
> could be something that helps user?
>
> Regards,
> Christos
>
> On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <m....@gmail.com>
> wrote:
>
> > On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <ok...@gmail.com>
> > wrote:
> >
> > > Hi Christos,
> > >
> > > Given that you have familiarized yourself with the codebase, which area
> > of
> > > the codebase do you feel:
> > >
> > > 1. you understand the best, and
> > > 2. are interested in working on.
> > >
> > > Given that information, I will be able to figure out something
> particular
> > > for you to do.
> > >
> >
> > You should also feel free to pick an issue off of JIRA yourself, or even
> > create an issue and submit a patch for it.
> >
> >
> > >
> > > Thanks,
> > > Marko.
> > >
> > > http://markorodriguez.com
> > >
> > > On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <
> chrikon1994@gmail.com>
> > > wrote:
> > >
> > > > Hello everyone,
> > > >
> > > > I have read your advices how to start and how to be familiarized with
> > the
> > > > codebase. After some time I spent exploring the code, I believe I am
> > > ready
> > > > to start specific changes in the code.
> > > >
> > > > So am sending this message to ask you, if some of you have ideas
> about
> > > > features or improvement and you want one more for help.
> > > >
> > > > Also if you have some issues you want some help please let me know
> > (jira
> > > > account chrikon).
> > > >
> > > > Thanks in advance,
> > > >
> > > > Regards
> > > > Christos
> > > >
> > > > On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <
> > > chrikon1994@gmail.com>
> > > > wrote:
> > > >
> > > >> Sorry Hadrian thank you for your correction, this will not happen
> > again!
> > > >>
> > > >> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <
> hzbarcea@gmail.com>
> > > >> wrote:
> > > >>
> > > >>> Hi Christos,
> > > >>>
> > > >>> First off, I am not a Mister :), just Hadrian.
> > > >>>
> > > >>> Yes, the idea is to collaborate, that's what open source is about.
> > > >>>
> > > >>> Good luck,
> > > >>> Hadrian
> > > >>>
> > > >>>
> > > >>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
> > > >>>
> > > >>>> Firstly thank you all for your suggestions, all of them are very
> > > helpful.
> > > >>>>
> > > >>>> In this moment I follow the very good advice and I am reading
> > > >>>> documentation, because next Wednesday I have to make a
> presentation
> > > for
> > > >>>> tinkerpop in front of my class!
> > > >>>>
> > > >>>> Marko I have to write code for my assignment, but in my free time
> it
> > > is
> > > >>>> an
> > > >>>> interesting work.
> > > >>>>
> > > >>>> Although Javadoc it is applicable to my assignment, I think. I
> will
> > > ask
> > > >>>> and
> > > >>>> I will have news.
> > > >>>>
> > > >>>> If Mr. Hadrian Zbarcea are working on it, I would like not to
> > > interfere
> > > >>>> in
> > > >>>> your job, or we can cooperate.
> > > >>>> Before that discussion I have to contact to my academic supervisor
> > in
> > > >>>> order
> > > >>>> to be 100% sure that this is ok.
> > > >>>>
> > > >>>> P.S. I hope my English is at least understandable, if not so
> please
> > > ask
> > > >>>> me
> > > >>>> again.
> > > >>>>
> > > >>>> Thank you all.
> > > >>>> Christos
> > > >>>>
> > > >>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <
> > hzbarcea@gmail.com>
> > > >>>> wrote:
> > > >>>>
> > > >>>> That's something I am interested in too.
> > > >>>>> Hadrian
> > > >>>>>
> > > >>>>>
> > > >>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
> > > >>>>>
> > > >>>>> Hi Christos,
> > > >>>>>>
> > > >>>>>> Another thing that we need is more JavaDoc! Its not sexy, but
> boy
> > > would
> > > >>>>>> be it be great to have someone go through and JavaDoc-up
> > > GraphTraversal
> > > >>>>>> (all those methods…).
> > > >>>>>>
> > > >>>>>> https://github.com/apache/incubator-tinkerpop/blob/
> > > >>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
> > > >>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
> > > >>>>>>
> > > >>>>>> …the docs provide a description of each step.
> > > >>>>>>
> > > >>>>>> http://tinkerpop.incubator.apache.org/docs/3.0.0-
> > > >>>>>> SNAPSHOT/#traversal (see the TOC for direct clicking to any
> > > particular
> > > >>>>>> step)
> > > >>>>>>
> > > >>>>>> I would say that would be more helpful now than a "Through the
> > > >>>>>> TinkerPop"-tutorial.
> > > >>>>>>
> > > >>>>>> Finally, what else would be helpful --- more test cases. If you
> > are
> > > >>>>>> interested in testing, I can get your set up in with "a pattern"
> > so
> > > >>>>>> you pop
> > > >>>>>> out more process/ tests. For example:
> > > >>>>>>
> > > >>>>>> https://github.com/apache/incubator-tinkerpop/blob/
> > > >>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
> > > >>>>>> gremlin/process/traversal/step/map/CountTest.java
> > > >>>>>>
> > > >>>>>> Thanks,
> > > >>>>>> Marko.
> > > >>>>>>
> > > >>>>>> http://markorodriguez.com
> > > >>>>>>
> > > >>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <
> > okrammarko@gmail.com>
> > > >>>>>> wrote:
> > > >>>>>>
> > > >>>>>> Hi Christos,
> > > >>>>>>
> > > >>>>>>>
> > > >>>>>>> Are you interested in writing code or perhaps, writing a
> > tutorial?
> > > >>>>>>>
> > > >>>>>>> It would be nice to have an in-depth tutorial on TinkerPop3.
> For
> > > >>>>>>> instance, find a reasonably sized dataset (<1 million edges),
> > parse
> > > >>>>>>> it into
> > > >>>>>>> a graph, do some analysis on it, expose it via Gremlin Server,
> > OLTP
> > > >>>>>>> and
> > > >>>>>>> OLAP queries hitting it, etc. Write up the path you took into
> an
> > > >>>>>>> AsciiDoc
> > > >>>>>>> and we could put it on the Apache TinkerPop site as a "Through
> > the
> > > >>>>>>> TinkerPop" tutorial. Be great if you could touch on every
> aspect
> > of
> > > >>>>>>> the
> > > >>>>>>> TinkerPop framework in the tutorial.
> > > >>>>>>>
> > > >>>>>>> I would appreciate a contribution like that.
> > > >>>>>>>
> > > >>>>>>> Thanks,
> > > >>>>>>> Marko.
> > > >>>>>>>
> > > >>>>>>> http://markorodriguez.com
> > > >>>>>>>
> > > >>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
> > > m.ben.franklin@gmail.com>
> > > >>>>>>> wrote:
> > > >>>>>>>
> > > >>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen Mallette <
> > > >>>>>>> spmallette@gmail.com>
> > > >>>>>>>
> > > >>>>>>>> wrote:
> > > >>>>>>>>
> > > >>>>>>>> My suggestion would be for you to spend some time learning
> > about
> > > >>>>>>>>
> > > >>>>>>>>> TinkerPop
> > > >>>>>>>>> (reading the documentation, examining the code base, perusing
> > the
> > > >>>>>>>>> Jira
> > > >>>>>>>>> issue tracker, etc.) to determine if any particular part of
> the
> > > >>>>>>>>> stack
> > > >>>>>>>>> interests you.
> > > >>>>>>>>>
> > > >>>>>>>>>
> > > >>>>>>>>
> > > >>>>>>>> IMO, there is no better way to get involved than to pick
> > something
> > > >>>>>>>> that
> > > >>>>>>>> needs to be worked on and provide a patch for it. I would
> look
> > at
> > > >>>>>>>> JIRA
> > > >>>>>>>> and
> > > >>>>>>>> find an issue that interests you.
> > > >>>>>>>>
> > > >>>>>>>>
> > > >>>>>>>> In doing that, you might develop your own ideas as to
> > > >>>>>>>>
> > > >>>>>>>>> where/what you think you are best suited to contribute. At
> > that
> > > >>>>>>>>> point
> > > >>>>>>>>> you
> > > >>>>>>>>> could post those ideas here in the mailing list for feedback.
> > > >>>>>>>>>
> > > >>>>>>>>>
> > > >>>>>>>>>
> > > >>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos Oikonomou <
> > > >>>>>>>>> chrikon1994@gmail.com
> > > >>>>>>>>>
> > > >>>>>>>>>
> > > >>>>>>>>>> wrote:
> > > >>>>>>>>>>
> > > >>>>>>>>>
> > > >>>>>>>>> Hi Stephen
> > > >>>>>>>>>
> > > >>>>>>>>>> When I start I was not familiar with the project nor the
> > > >>>>>>>>>> architecture/codebase.
> > > >>>>>>>>>> But I am reading about tinkerpop and searching in the code
> and
> > > >>>>>>>>>> I am thinking to make some simple examples in order to be
> more
> > > >>>>>>>>>> familiar
> > > >>>>>>>>>> with the functionality.
> > > >>>>>>>>>> So I am not now very familiar but I try to be in the near
> > > future.
> > > >>>>>>>>>>
> > > >>>>>>>>>> Christos
> > > >>>>>>>>>>
> > > >>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen Mallette <
> > > >>>>>>>>>> spmallette@gmail.com>
> > > >>>>>>>>>> wrote:
> > > >>>>>>>>>>
> > > >>>>>>>>>> Hi Christos, we appreciate your offer to contribute. Could
> > you
> > > >>>>>>>>>> tell
> > > >>>>>>>>>>
> > > >>>>>>>>>>> us
> > > >>>>>>>>>>> what kind of experience you have with TinkerPop so far?
> Are
> > > you
> > > >>>>>>>>>>> at
> > > >>>>>>>>>>> all
> > > >>>>>>>>>>> familiar with the architecture/codebase?
> > > >>>>>>>>>>>
> > > >>>>>>>>>>> Stephen
> > > >>>>>>>>>>>
> > > >>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos Oikonomou <
> > > >>>>>>>>>>> chrikon1994@gmail.com>
> > > >>>>>>>>>>> wrote:
> > > >>>>>>>>>>>
> > > >>>>>>>>>>> Dear Tinkerpop Development Team
> > > >>>>>>>>>>>
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>> My name is Christos Economou.
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>> I would like to contribute in the tinkerpop3.
> > > >>>>>>>>>>>> This contribution will be a part of an assignment in one
> of
> > my
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>> classes.
> > > >>>>>>>>>>>
> > > >>>>>>>>>>
> > > >>>>>>>>>
> > > >>>>>>>>>> I am in my third year of study at Athens University of
> > Economics
> > > >>>>>>>>>>>> and
> > > >>>>>>>>>>>> Business (Greece | Hellas).In this semester I attend in
> > > lectures
> > > >>>>>>>>>>>> that
> > > >>>>>>>>>>>> called "Advanced Topics in Software Engineering" by
> > professor
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>> Diomidis
> > > >>>>>>>>>>>
> > > >>>>>>>>>>
> > > >>>>>>>>> Spinellis.
> > > >>>>>>>>>>
> > > >>>>>>>>>>>
> > > >>>>>>>>>>>> As assignment I have to contribute in an open source
> > project.
> > > I
> > > >>>>>>>>>>>> would
> > > >>>>>>>>>>>> prefer to contribute to tinkerpop3. More specifically I
> > > >>>>>>>>>>>> understand
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>> that
> > > >>>>>>>>>>>
> > > >>>>>>>>>>
> > > >>>>>>>>> in
> > > >>>>>>>>>>
> > > >>>>>>>>>>>
> > > >>>>>>>>>>> big projects, like this, always exists work on integration
> > and
> > > >>>>>>>>>>>> collaboration between components and subsystems. So I do
> not
> > > have
> > > >>>>>>>>>>>> any
> > > >>>>>>>>>>>> problem to work on that. But I am more interested in
> > creative
> > > >>>>>>>>>>>> work
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>> like
> > > >>>>>>>>>>>
> > > >>>>>>>>>>
> > > >>>>>>>>> implementation of some algorithm or on a new functionality.
> > > >>>>>>>>>>
> > > >>>>>>>>>>>
> > > >>>>>>>>>>>> I have to mention I have a hard constraint, that my
> > > contribution
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>> should
> > > >>>>>>>>>>>
> > > >>>>>>>>>>
> > > >>>>>>>>> be
> > > >>>>>>>>>>
> > > >>>>>>>>>>>
> > > >>>>>>>>>>> at least 100 - 200 lines of code.
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>> So I am writing you to ask if you have in mind some
> > > >>>>>>>>>>>> functionalities
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>> that
> > > >>>>>>>>>>>
> > > >>>>>>>>>>
> > > >>>>>>>>>> I
> > > >>>>>>>>>>>
> > > >>>>>>>>>>> can help in development. Here some information about my
> > > >>>>>>>>>>>> knowledge in
> > > >>>>>>>>>>>> software engineering and programming languages
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>> http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>> inetpub/detfolio/.
> > > >>>>>>>>>>
> > > >>>>>>>>>>
> > > >>>>>>>>>>> Thank you for your time and attention.
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>> Regards,
> > > >>>>>>>>>>>> Christos Oikonomou
> > > >>>>>>>>>>>> Assistant researcher at ISTLab
> > > >>>>>>>>>>>> http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
> > > >>>>>>>>>>>> Github: https://github.com/xristosoik
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>>
> > > >>>>>>>>>>>
> > > >>>>>>>>>>
> > > >>>>>>>>>
> > > >>>>>>>
> > > >>>>>>
> > > >>>>>>
> > > >>>>
> > > >>
> > >
> > >
> >
>
Re: Contributing to tinkerpop3
Posted by Christos Oikonomou <ch...@gmail.com>.
Hello and sorry for the delay. Thanks for the answers.
I have done a general overview of all the code base. But more familiarized
I am in gremlin-core and gremlin-console.
I prefer the assignment of issues because I wants to help also to the
faster achievement of the project planning in general.
Also I have an idea in documentation. A gremlin-command that display in
gremlin-console user documentation or javadocs of a gremlin functionality
could be something that helps user?
Regards,
Christos
On Fri, Apr 24, 2015 at 3:49 AM, Matt Franklin <m....@gmail.com>
wrote:
> On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <ok...@gmail.com>
> wrote:
>
> > Hi Christos,
> >
> > Given that you have familiarized yourself with the codebase, which area
> of
> > the codebase do you feel:
> >
> > 1. you understand the best, and
> > 2. are interested in working on.
> >
> > Given that information, I will be able to figure out something particular
> > for you to do.
> >
>
> You should also feel free to pick an issue off of JIRA yourself, or even
> create an issue and submit a patch for it.
>
>
> >
> > Thanks,
> > Marko.
> >
> > http://markorodriguez.com
> >
> > On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <ch...@gmail.com>
> > wrote:
> >
> > > Hello everyone,
> > >
> > > I have read your advices how to start and how to be familiarized with
> the
> > > codebase. After some time I spent exploring the code, I believe I am
> > ready
> > > to start specific changes in the code.
> > >
> > > So am sending this message to ask you, if some of you have ideas about
> > > features or improvement and you want one more for help.
> > >
> > > Also if you have some issues you want some help please let me know
> (jira
> > > account chrikon).
> > >
> > > Thanks in advance,
> > >
> > > Regards
> > > Christos
> > >
> > > On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <
> > chrikon1994@gmail.com>
> > > wrote:
> > >
> > >> Sorry Hadrian thank you for your correction, this will not happen
> again!
> > >>
> > >> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <hz...@gmail.com>
> > >> wrote:
> > >>
> > >>> Hi Christos,
> > >>>
> > >>> First off, I am not a Mister :), just Hadrian.
> > >>>
> > >>> Yes, the idea is to collaborate, that's what open source is about.
> > >>>
> > >>> Good luck,
> > >>> Hadrian
> > >>>
> > >>>
> > >>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
> > >>>
> > >>>> Firstly thank you all for your suggestions, all of them are very
> > helpful.
> > >>>>
> > >>>> In this moment I follow the very good advice and I am reading
> > >>>> documentation, because next Wednesday I have to make a presentation
> > for
> > >>>> tinkerpop in front of my class!
> > >>>>
> > >>>> Marko I have to write code for my assignment, but in my free time it
> > is
> > >>>> an
> > >>>> interesting work.
> > >>>>
> > >>>> Although Javadoc it is applicable to my assignment, I think. I will
> > ask
> > >>>> and
> > >>>> I will have news.
> > >>>>
> > >>>> If Mr. Hadrian Zbarcea are working on it, I would like not to
> > interfere
> > >>>> in
> > >>>> your job, or we can cooperate.
> > >>>> Before that discussion I have to contact to my academic supervisor
> in
> > >>>> order
> > >>>> to be 100% sure that this is ok.
> > >>>>
> > >>>> P.S. I hope my English is at least understandable, if not so please
> > ask
> > >>>> me
> > >>>> again.
> > >>>>
> > >>>> Thank you all.
> > >>>> Christos
> > >>>>
> > >>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <
> hzbarcea@gmail.com>
> > >>>> wrote:
> > >>>>
> > >>>> That's something I am interested in too.
> > >>>>> Hadrian
> > >>>>>
> > >>>>>
> > >>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
> > >>>>>
> > >>>>> Hi Christos,
> > >>>>>>
> > >>>>>> Another thing that we need is more JavaDoc! Its not sexy, but boy
> > would
> > >>>>>> be it be great to have someone go through and JavaDoc-up
> > GraphTraversal
> > >>>>>> (all those methods…).
> > >>>>>>
> > >>>>>> https://github.com/apache/incubator-tinkerpop/blob/
> > >>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
> > >>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
> > >>>>>>
> > >>>>>> …the docs provide a description of each step.
> > >>>>>>
> > >>>>>> http://tinkerpop.incubator.apache.org/docs/3.0.0-
> > >>>>>> SNAPSHOT/#traversal (see the TOC for direct clicking to any
> > particular
> > >>>>>> step)
> > >>>>>>
> > >>>>>> I would say that would be more helpful now than a "Through the
> > >>>>>> TinkerPop"-tutorial.
> > >>>>>>
> > >>>>>> Finally, what else would be helpful --- more test cases. If you
> are
> > >>>>>> interested in testing, I can get your set up in with "a pattern"
> so
> > >>>>>> you pop
> > >>>>>> out more process/ tests. For example:
> > >>>>>>
> > >>>>>> https://github.com/apache/incubator-tinkerpop/blob/
> > >>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
> > >>>>>> gremlin/process/traversal/step/map/CountTest.java
> > >>>>>>
> > >>>>>> Thanks,
> > >>>>>> Marko.
> > >>>>>>
> > >>>>>> http://markorodriguez.com
> > >>>>>>
> > >>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <
> okrammarko@gmail.com>
> > >>>>>> wrote:
> > >>>>>>
> > >>>>>> Hi Christos,
> > >>>>>>
> > >>>>>>>
> > >>>>>>> Are you interested in writing code or perhaps, writing a
> tutorial?
> > >>>>>>>
> > >>>>>>> It would be nice to have an in-depth tutorial on TinkerPop3. For
> > >>>>>>> instance, find a reasonably sized dataset (<1 million edges),
> parse
> > >>>>>>> it into
> > >>>>>>> a graph, do some analysis on it, expose it via Gremlin Server,
> OLTP
> > >>>>>>> and
> > >>>>>>> OLAP queries hitting it, etc. Write up the path you took into an
> > >>>>>>> AsciiDoc
> > >>>>>>> and we could put it on the Apache TinkerPop site as a "Through
> the
> > >>>>>>> TinkerPop" tutorial. Be great if you could touch on every aspect
> of
> > >>>>>>> the
> > >>>>>>> TinkerPop framework in the tutorial.
> > >>>>>>>
> > >>>>>>> I would appreciate a contribution like that.
> > >>>>>>>
> > >>>>>>> Thanks,
> > >>>>>>> Marko.
> > >>>>>>>
> > >>>>>>> http://markorodriguez.com
> > >>>>>>>
> > >>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
> > m.ben.franklin@gmail.com>
> > >>>>>>> wrote:
> > >>>>>>>
> > >>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen Mallette <
> > >>>>>>> spmallette@gmail.com>
> > >>>>>>>
> > >>>>>>>> wrote:
> > >>>>>>>>
> > >>>>>>>> My suggestion would be for you to spend some time learning
> about
> > >>>>>>>>
> > >>>>>>>>> TinkerPop
> > >>>>>>>>> (reading the documentation, examining the code base, perusing
> the
> > >>>>>>>>> Jira
> > >>>>>>>>> issue tracker, etc.) to determine if any particular part of the
> > >>>>>>>>> stack
> > >>>>>>>>> interests you.
> > >>>>>>>>>
> > >>>>>>>>>
> > >>>>>>>>
> > >>>>>>>> IMO, there is no better way to get involved than to pick
> something
> > >>>>>>>> that
> > >>>>>>>> needs to be worked on and provide a patch for it. I would look
> at
> > >>>>>>>> JIRA
> > >>>>>>>> and
> > >>>>>>>> find an issue that interests you.
> > >>>>>>>>
> > >>>>>>>>
> > >>>>>>>> In doing that, you might develop your own ideas as to
> > >>>>>>>>
> > >>>>>>>>> where/what you think you are best suited to contribute. At
> that
> > >>>>>>>>> point
> > >>>>>>>>> you
> > >>>>>>>>> could post those ideas here in the mailing list for feedback.
> > >>>>>>>>>
> > >>>>>>>>>
> > >>>>>>>>>
> > >>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos Oikonomou <
> > >>>>>>>>> chrikon1994@gmail.com
> > >>>>>>>>>
> > >>>>>>>>>
> > >>>>>>>>>> wrote:
> > >>>>>>>>>>
> > >>>>>>>>>
> > >>>>>>>>> Hi Stephen
> > >>>>>>>>>
> > >>>>>>>>>> When I start I was not familiar with the project nor the
> > >>>>>>>>>> architecture/codebase.
> > >>>>>>>>>> But I am reading about tinkerpop and searching in the code and
> > >>>>>>>>>> I am thinking to make some simple examples in order to be more
> > >>>>>>>>>> familiar
> > >>>>>>>>>> with the functionality.
> > >>>>>>>>>> So I am not now very familiar but I try to be in the near
> > future.
> > >>>>>>>>>>
> > >>>>>>>>>> Christos
> > >>>>>>>>>>
> > >>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen Mallette <
> > >>>>>>>>>> spmallette@gmail.com>
> > >>>>>>>>>> wrote:
> > >>>>>>>>>>
> > >>>>>>>>>> Hi Christos, we appreciate your offer to contribute. Could
> you
> > >>>>>>>>>> tell
> > >>>>>>>>>>
> > >>>>>>>>>>> us
> > >>>>>>>>>>> what kind of experience you have with TinkerPop so far? Are
> > you
> > >>>>>>>>>>> at
> > >>>>>>>>>>> all
> > >>>>>>>>>>> familiar with the architecture/codebase?
> > >>>>>>>>>>>
> > >>>>>>>>>>> Stephen
> > >>>>>>>>>>>
> > >>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos Oikonomou <
> > >>>>>>>>>>> chrikon1994@gmail.com>
> > >>>>>>>>>>> wrote:
> > >>>>>>>>>>>
> > >>>>>>>>>>> Dear Tinkerpop Development Team
> > >>>>>>>>>>>
> > >>>>>>>>>>>>
> > >>>>>>>>>>>> My name is Christos Economou.
> > >>>>>>>>>>>>
> > >>>>>>>>>>>> I would like to contribute in the tinkerpop3.
> > >>>>>>>>>>>> This contribution will be a part of an assignment in one of
> my
> > >>>>>>>>>>>>
> > >>>>>>>>>>>> classes.
> > >>>>>>>>>>>
> > >>>>>>>>>>
> > >>>>>>>>>
> > >>>>>>>>>> I am in my third year of study at Athens University of
> Economics
> > >>>>>>>>>>>> and
> > >>>>>>>>>>>> Business (Greece | Hellas).In this semester I attend in
> > lectures
> > >>>>>>>>>>>> that
> > >>>>>>>>>>>> called "Advanced Topics in Software Engineering" by
> professor
> > >>>>>>>>>>>>
> > >>>>>>>>>>>> Diomidis
> > >>>>>>>>>>>
> > >>>>>>>>>>
> > >>>>>>>>> Spinellis.
> > >>>>>>>>>>
> > >>>>>>>>>>>
> > >>>>>>>>>>>> As assignment I have to contribute in an open source
> project.
> > I
> > >>>>>>>>>>>> would
> > >>>>>>>>>>>> prefer to contribute to tinkerpop3. More specifically I
> > >>>>>>>>>>>> understand
> > >>>>>>>>>>>>
> > >>>>>>>>>>>> that
> > >>>>>>>>>>>
> > >>>>>>>>>>
> > >>>>>>>>> in
> > >>>>>>>>>>
> > >>>>>>>>>>>
> > >>>>>>>>>>> big projects, like this, always exists work on integration
> and
> > >>>>>>>>>>>> collaboration between components and subsystems. So I do not
> > have
> > >>>>>>>>>>>> any
> > >>>>>>>>>>>> problem to work on that. But I am more interested in
> creative
> > >>>>>>>>>>>> work
> > >>>>>>>>>>>>
> > >>>>>>>>>>>> like
> > >>>>>>>>>>>
> > >>>>>>>>>>
> > >>>>>>>>> implementation of some algorithm or on a new functionality.
> > >>>>>>>>>>
> > >>>>>>>>>>>
> > >>>>>>>>>>>> I have to mention I have a hard constraint, that my
> > contribution
> > >>>>>>>>>>>>
> > >>>>>>>>>>>> should
> > >>>>>>>>>>>
> > >>>>>>>>>>
> > >>>>>>>>> be
> > >>>>>>>>>>
> > >>>>>>>>>>>
> > >>>>>>>>>>> at least 100 - 200 lines of code.
> > >>>>>>>>>>>>
> > >>>>>>>>>>>> So I am writing you to ask if you have in mind some
> > >>>>>>>>>>>> functionalities
> > >>>>>>>>>>>>
> > >>>>>>>>>>>> that
> > >>>>>>>>>>>
> > >>>>>>>>>>
> > >>>>>>>>>> I
> > >>>>>>>>>>>
> > >>>>>>>>>>> can help in development. Here some information about my
> > >>>>>>>>>>>> knowledge in
> > >>>>>>>>>>>> software engineering and programming languages
> > >>>>>>>>>>>>
> > >>>>>>>>>>>> http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
> > >>>>>>>>>>>>
> > >>>>>>>>>>> inetpub/detfolio/.
> > >>>>>>>>>>
> > >>>>>>>>>>
> > >>>>>>>>>>> Thank you for your time and attention.
> > >>>>>>>>>>>>
> > >>>>>>>>>>>> Regards,
> > >>>>>>>>>>>> Christos Oikonomou
> > >>>>>>>>>>>> Assistant researcher at ISTLab
> > >>>>>>>>>>>> http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
> > >>>>>>>>>>>> Github: https://github.com/xristosoik
> > >>>>>>>>>>>>
> > >>>>>>>>>>>>
> > >>>>>>>>>>>>
> > >>>>>>>>>>>
> > >>>>>>>>>>
> > >>>>>>>>>
> > >>>>>>>
> > >>>>>>
> > >>>>>>
> > >>>>
> > >>
> >
> >
>
Re: Contributing to tinkerpop3
Posted by Matt Franklin <m....@gmail.com>.
On Thu, Apr 23, 2015 at 3:24 PM Marko Rodriguez <ok...@gmail.com>
wrote:
> Hi Christos,
>
> Given that you have familiarized yourself with the codebase, which area of
> the codebase do you feel:
>
> 1. you understand the best, and
> 2. are interested in working on.
>
> Given that information, I will be able to figure out something particular
> for you to do.
>
You should also feel free to pick an issue off of JIRA yourself, or even
create an issue and submit a patch for it.
>
> Thanks,
> Marko.
>
> http://markorodriguez.com
>
> On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <ch...@gmail.com>
> wrote:
>
> > Hello everyone,
> >
> > I have read your advices how to start and how to be familiarized with the
> > codebase. After some time I spent exploring the code, I believe I am
> ready
> > to start specific changes in the code.
> >
> > So am sending this message to ask you, if some of you have ideas about
> > features or improvement and you want one more for help.
> >
> > Also if you have some issues you want some help please let me know (jira
> > account chrikon).
> >
> > Thanks in advance,
> >
> > Regards
> > Christos
> >
> > On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <
> chrikon1994@gmail.com>
> > wrote:
> >
> >> Sorry Hadrian thank you for your correction, this will not happen again!
> >>
> >> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <hz...@gmail.com>
> >> wrote:
> >>
> >>> Hi Christos,
> >>>
> >>> First off, I am not a Mister :), just Hadrian.
> >>>
> >>> Yes, the idea is to collaborate, that's what open source is about.
> >>>
> >>> Good luck,
> >>> Hadrian
> >>>
> >>>
> >>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
> >>>
> >>>> Firstly thank you all for your suggestions, all of them are very
> helpful.
> >>>>
> >>>> In this moment I follow the very good advice and I am reading
> >>>> documentation, because next Wednesday I have to make a presentation
> for
> >>>> tinkerpop in front of my class!
> >>>>
> >>>> Marko I have to write code for my assignment, but in my free time it
> is
> >>>> an
> >>>> interesting work.
> >>>>
> >>>> Although Javadoc it is applicable to my assignment, I think. I will
> ask
> >>>> and
> >>>> I will have news.
> >>>>
> >>>> If Mr. Hadrian Zbarcea are working on it, I would like not to
> interfere
> >>>> in
> >>>> your job, or we can cooperate.
> >>>> Before that discussion I have to contact to my academic supervisor in
> >>>> order
> >>>> to be 100% sure that this is ok.
> >>>>
> >>>> P.S. I hope my English is at least understandable, if not so please
> ask
> >>>> me
> >>>> again.
> >>>>
> >>>> Thank you all.
> >>>> Christos
> >>>>
> >>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <hz...@gmail.com>
> >>>> wrote:
> >>>>
> >>>> That's something I am interested in too.
> >>>>> Hadrian
> >>>>>
> >>>>>
> >>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
> >>>>>
> >>>>> Hi Christos,
> >>>>>>
> >>>>>> Another thing that we need is more JavaDoc! Its not sexy, but boy
> would
> >>>>>> be it be great to have someone go through and JavaDoc-up
> GraphTraversal
> >>>>>> (all those methods…).
> >>>>>>
> >>>>>> https://github.com/apache/incubator-tinkerpop/blob/
> >>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
> >>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
> >>>>>>
> >>>>>> …the docs provide a description of each step.
> >>>>>>
> >>>>>> http://tinkerpop.incubator.apache.org/docs/3.0.0-
> >>>>>> SNAPSHOT/#traversal (see the TOC for direct clicking to any
> particular
> >>>>>> step)
> >>>>>>
> >>>>>> I would say that would be more helpful now than a "Through the
> >>>>>> TinkerPop"-tutorial.
> >>>>>>
> >>>>>> Finally, what else would be helpful --- more test cases. If you are
> >>>>>> interested in testing, I can get your set up in with "a pattern" so
> >>>>>> you pop
> >>>>>> out more process/ tests. For example:
> >>>>>>
> >>>>>> https://github.com/apache/incubator-tinkerpop/blob/
> >>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
> >>>>>> gremlin/process/traversal/step/map/CountTest.java
> >>>>>>
> >>>>>> Thanks,
> >>>>>> Marko.
> >>>>>>
> >>>>>> http://markorodriguez.com
> >>>>>>
> >>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <ok...@gmail.com>
> >>>>>> wrote:
> >>>>>>
> >>>>>> Hi Christos,
> >>>>>>
> >>>>>>>
> >>>>>>> Are you interested in writing code or perhaps, writing a tutorial?
> >>>>>>>
> >>>>>>> It would be nice to have an in-depth tutorial on TinkerPop3. For
> >>>>>>> instance, find a reasonably sized dataset (<1 million edges), parse
> >>>>>>> it into
> >>>>>>> a graph, do some analysis on it, expose it via Gremlin Server, OLTP
> >>>>>>> and
> >>>>>>> OLAP queries hitting it, etc. Write up the path you took into an
> >>>>>>> AsciiDoc
> >>>>>>> and we could put it on the Apache TinkerPop site as a "Through the
> >>>>>>> TinkerPop" tutorial. Be great if you could touch on every aspect of
> >>>>>>> the
> >>>>>>> TinkerPop framework in the tutorial.
> >>>>>>>
> >>>>>>> I would appreciate a contribution like that.
> >>>>>>>
> >>>>>>> Thanks,
> >>>>>>> Marko.
> >>>>>>>
> >>>>>>> http://markorodriguez.com
> >>>>>>>
> >>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <
> m.ben.franklin@gmail.com>
> >>>>>>> wrote:
> >>>>>>>
> >>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen Mallette <
> >>>>>>> spmallette@gmail.com>
> >>>>>>>
> >>>>>>>> wrote:
> >>>>>>>>
> >>>>>>>> My suggestion would be for you to spend some time learning about
> >>>>>>>>
> >>>>>>>>> TinkerPop
> >>>>>>>>> (reading the documentation, examining the code base, perusing the
> >>>>>>>>> Jira
> >>>>>>>>> issue tracker, etc.) to determine if any particular part of the
> >>>>>>>>> stack
> >>>>>>>>> interests you.
> >>>>>>>>>
> >>>>>>>>>
> >>>>>>>>
> >>>>>>>> IMO, there is no better way to get involved than to pick something
> >>>>>>>> that
> >>>>>>>> needs to be worked on and provide a patch for it. I would look at
> >>>>>>>> JIRA
> >>>>>>>> and
> >>>>>>>> find an issue that interests you.
> >>>>>>>>
> >>>>>>>>
> >>>>>>>> In doing that, you might develop your own ideas as to
> >>>>>>>>
> >>>>>>>>> where/what you think you are best suited to contribute. At that
> >>>>>>>>> point
> >>>>>>>>> you
> >>>>>>>>> could post those ideas here in the mailing list for feedback.
> >>>>>>>>>
> >>>>>>>>>
> >>>>>>>>>
> >>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos Oikonomou <
> >>>>>>>>> chrikon1994@gmail.com
> >>>>>>>>>
> >>>>>>>>>
> >>>>>>>>>> wrote:
> >>>>>>>>>>
> >>>>>>>>>
> >>>>>>>>> Hi Stephen
> >>>>>>>>>
> >>>>>>>>>> When I start I was not familiar with the project nor the
> >>>>>>>>>> architecture/codebase.
> >>>>>>>>>> But I am reading about tinkerpop and searching in the code and
> >>>>>>>>>> I am thinking to make some simple examples in order to be more
> >>>>>>>>>> familiar
> >>>>>>>>>> with the functionality.
> >>>>>>>>>> So I am not now very familiar but I try to be in the near
> future.
> >>>>>>>>>>
> >>>>>>>>>> Christos
> >>>>>>>>>>
> >>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen Mallette <
> >>>>>>>>>> spmallette@gmail.com>
> >>>>>>>>>> wrote:
> >>>>>>>>>>
> >>>>>>>>>> Hi Christos, we appreciate your offer to contribute. Could you
> >>>>>>>>>> tell
> >>>>>>>>>>
> >>>>>>>>>>> us
> >>>>>>>>>>> what kind of experience you have with TinkerPop so far? Are
> you
> >>>>>>>>>>> at
> >>>>>>>>>>> all
> >>>>>>>>>>> familiar with the architecture/codebase?
> >>>>>>>>>>>
> >>>>>>>>>>> Stephen
> >>>>>>>>>>>
> >>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos Oikonomou <
> >>>>>>>>>>> chrikon1994@gmail.com>
> >>>>>>>>>>> wrote:
> >>>>>>>>>>>
> >>>>>>>>>>> Dear Tinkerpop Development Team
> >>>>>>>>>>>
> >>>>>>>>>>>>
> >>>>>>>>>>>> My name is Christos Economou.
> >>>>>>>>>>>>
> >>>>>>>>>>>> I would like to contribute in the tinkerpop3.
> >>>>>>>>>>>> This contribution will be a part of an assignment in one of my
> >>>>>>>>>>>>
> >>>>>>>>>>>> classes.
> >>>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>>
> >>>>>>>>>> I am in my third year of study at Athens University of Economics
> >>>>>>>>>>>> and
> >>>>>>>>>>>> Business (Greece | Hellas).In this semester I attend in
> lectures
> >>>>>>>>>>>> that
> >>>>>>>>>>>> called "Advanced Topics in Software Engineering" by professor
> >>>>>>>>>>>>
> >>>>>>>>>>>> Diomidis
> >>>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>> Spinellis.
> >>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>>> As assignment I have to contribute in an open source project.
> I
> >>>>>>>>>>>> would
> >>>>>>>>>>>> prefer to contribute to tinkerpop3. More specifically I
> >>>>>>>>>>>> understand
> >>>>>>>>>>>>
> >>>>>>>>>>>> that
> >>>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>> in
> >>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>> big projects, like this, always exists work on integration and
> >>>>>>>>>>>> collaboration between components and subsystems. So I do not
> have
> >>>>>>>>>>>> any
> >>>>>>>>>>>> problem to work on that. But I am more interested in creative
> >>>>>>>>>>>> work
> >>>>>>>>>>>>
> >>>>>>>>>>>> like
> >>>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>> implementation of some algorithm or on a new functionality.
> >>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>>> I have to mention I have a hard constraint, that my
> contribution
> >>>>>>>>>>>>
> >>>>>>>>>>>> should
> >>>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>> be
> >>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>> at least 100 - 200 lines of code.
> >>>>>>>>>>>>
> >>>>>>>>>>>> So I am writing you to ask if you have in mind some
> >>>>>>>>>>>> functionalities
> >>>>>>>>>>>>
> >>>>>>>>>>>> that
> >>>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>>> I
> >>>>>>>>>>>
> >>>>>>>>>>> can help in development. Here some information about my
> >>>>>>>>>>>> knowledge in
> >>>>>>>>>>>> software engineering and programming languages
> >>>>>>>>>>>>
> >>>>>>>>>>>> http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
> >>>>>>>>>>>>
> >>>>>>>>>>> inetpub/detfolio/.
> >>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>>>> Thank you for your time and attention.
> >>>>>>>>>>>>
> >>>>>>>>>>>> Regards,
> >>>>>>>>>>>> Christos Oikonomou
> >>>>>>>>>>>> Assistant researcher at ISTLab
> >>>>>>>>>>>> http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
> >>>>>>>>>>>> Github: https://github.com/xristosoik
> >>>>>>>>>>>>
> >>>>>>>>>>>>
> >>>>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>>
> >>>>>>>
> >>>>>>
> >>>>>>
> >>>>
> >>
>
>
Re: Contributing to tinkerpop3
Posted by Marko Rodriguez <ok...@gmail.com>.
Hi Christos,
Given that you have familiarized yourself with the codebase, which area of the codebase do you feel:
1. you understand the best, and
2. are interested in working on.
Given that information, I will be able to figure out something particular for you to do.
Thanks,
Marko.
http://markorodriguez.com
On Apr 22, 2015, at 12:01 PM, Christos Oikonomou <ch...@gmail.com> wrote:
> Hello everyone,
>
> I have read your advices how to start and how to be familiarized with the
> codebase. After some time I spent exploring the code, I believe I am ready
> to start specific changes in the code.
>
> So am sending this message to ask you, if some of you have ideas about
> features or improvement and you want one more for help.
>
> Also if you have some issues you want some help please let me know (jira
> account chrikon).
>
> Thanks in advance,
>
> Regards
> Christos
>
> On Thu, Mar 26, 2015 at 8:53 PM, Christos Oikonomou <ch...@gmail.com>
> wrote:
>
>> Sorry Hadrian thank you for your correction, this will not happen again!
>>
>> On Thu, Mar 26, 2015 at 8:45 PM, Hadrian Zbarcea <hz...@gmail.com>
>> wrote:
>>
>>> Hi Christos,
>>>
>>> First off, I am not a Mister :), just Hadrian.
>>>
>>> Yes, the idea is to collaborate, that's what open source is about.
>>>
>>> Good luck,
>>> Hadrian
>>>
>>>
>>> On 03/26/2015 02:33 PM, Christos Oikonomou wrote:
>>>
>>>> Firstly thank you all for your suggestions, all of them are very helpful.
>>>>
>>>> In this moment I follow the very good advice and I am reading
>>>> documentation, because next Wednesday I have to make a presentation for
>>>> tinkerpop in front of my class!
>>>>
>>>> Marko I have to write code for my assignment, but in my free time it is
>>>> an
>>>> interesting work.
>>>>
>>>> Although Javadoc it is applicable to my assignment, I think. I will ask
>>>> and
>>>> I will have news.
>>>>
>>>> If Mr. Hadrian Zbarcea are working on it, I would like not to interfere
>>>> in
>>>> your job, or we can cooperate.
>>>> Before that discussion I have to contact to my academic supervisor in
>>>> order
>>>> to be 100% sure that this is ok.
>>>>
>>>> P.S. I hope my English is at least understandable, if not so please ask
>>>> me
>>>> again.
>>>>
>>>> Thank you all.
>>>> Christos
>>>>
>>>> On Thu, Mar 26, 2015 at 4:59 PM, Hadrian Zbarcea <hz...@gmail.com>
>>>> wrote:
>>>>
>>>> That's something I am interested in too.
>>>>> Hadrian
>>>>>
>>>>>
>>>>> On 03/26/2015 09:26 AM, Marko Rodriguez wrote:
>>>>>
>>>>> Hi Christos,
>>>>>>
>>>>>> Another thing that we need is more JavaDoc! Its not sexy, but boy would
>>>>>> be it be great to have someone go through and JavaDoc-up GraphTraversal
>>>>>> (all those methods…).
>>>>>>
>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
>>>>>> master/gremlin-core/src/main/java/org/apache/tinkerpop/
>>>>>> gremlin/process/traversal/dsl/graph/GraphTraversal.java
>>>>>>
>>>>>> …the docs provide a description of each step.
>>>>>>
>>>>>> http://tinkerpop.incubator.apache.org/docs/3.0.0-
>>>>>> SNAPSHOT/#traversal (see the TOC for direct clicking to any particular
>>>>>> step)
>>>>>>
>>>>>> I would say that would be more helpful now than a "Through the
>>>>>> TinkerPop"-tutorial.
>>>>>>
>>>>>> Finally, what else would be helpful --- more test cases. If you are
>>>>>> interested in testing, I can get your set up in with "a pattern" so
>>>>>> you pop
>>>>>> out more process/ tests. For example:
>>>>>>
>>>>>> https://github.com/apache/incubator-tinkerpop/blob/
>>>>>> master/gremlin-test/src/main/java/org/apache/tinkerpop/
>>>>>> gremlin/process/traversal/step/map/CountTest.java
>>>>>>
>>>>>> Thanks,
>>>>>> Marko.
>>>>>>
>>>>>> http://markorodriguez.com
>>>>>>
>>>>>> On Mar 26, 2015, at 6:57 AM, Marko Rodriguez <ok...@gmail.com>
>>>>>> wrote:
>>>>>>
>>>>>> Hi Christos,
>>>>>>
>>>>>>>
>>>>>>> Are you interested in writing code or perhaps, writing a tutorial?
>>>>>>>
>>>>>>> It would be nice to have an in-depth tutorial on TinkerPop3. For
>>>>>>> instance, find a reasonably sized dataset (<1 million edges), parse
>>>>>>> it into
>>>>>>> a graph, do some analysis on it, expose it via Gremlin Server, OLTP
>>>>>>> and
>>>>>>> OLAP queries hitting it, etc. Write up the path you took into an
>>>>>>> AsciiDoc
>>>>>>> and we could put it on the Apache TinkerPop site as a "Through the
>>>>>>> TinkerPop" tutorial. Be great if you could touch on every aspect of
>>>>>>> the
>>>>>>> TinkerPop framework in the tutorial.
>>>>>>>
>>>>>>> I would appreciate a contribution like that.
>>>>>>>
>>>>>>> Thanks,
>>>>>>> Marko.
>>>>>>>
>>>>>>> http://markorodriguez.com
>>>>>>>
>>>>>>> On Mar 26, 2015, at 6:46 AM, Matt Franklin <m....@gmail.com>
>>>>>>> wrote:
>>>>>>>
>>>>>>> On Tue, Mar 24, 2015 at 3:35 PM Stephen Mallette <
>>>>>>> spmallette@gmail.com>
>>>>>>>
>>>>>>>> wrote:
>>>>>>>>
>>>>>>>> My suggestion would be for you to spend some time learning about
>>>>>>>>
>>>>>>>>> TinkerPop
>>>>>>>>> (reading the documentation, examining the code base, perusing the
>>>>>>>>> Jira
>>>>>>>>> issue tracker, etc.) to determine if any particular part of the
>>>>>>>>> stack
>>>>>>>>> interests you.
>>>>>>>>>
>>>>>>>>>
>>>>>>>>
>>>>>>>> IMO, there is no better way to get involved than to pick something
>>>>>>>> that
>>>>>>>> needs to be worked on and provide a patch for it. I would look at
>>>>>>>> JIRA
>>>>>>>> and
>>>>>>>> find an issue that interests you.
>>>>>>>>
>>>>>>>>
>>>>>>>> In doing that, you might develop your own ideas as to
>>>>>>>>
>>>>>>>>> where/what you think you are best suited to contribute. At that
>>>>>>>>> point
>>>>>>>>> you
>>>>>>>>> could post those ideas here in the mailing list for feedback.
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>> On Tue, Mar 24, 2015 at 3:16 PM, Christos Oikonomou <
>>>>>>>>> chrikon1994@gmail.com
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>> wrote:
>>>>>>>>>>
>>>>>>>>>
>>>>>>>>> Hi Stephen
>>>>>>>>>
>>>>>>>>>> When I start I was not familiar with the project nor the
>>>>>>>>>> architecture/codebase.
>>>>>>>>>> But I am reading about tinkerpop and searching in the code and
>>>>>>>>>> I am thinking to make some simple examples in order to be more
>>>>>>>>>> familiar
>>>>>>>>>> with the functionality.
>>>>>>>>>> So I am not now very familiar but I try to be in the near future.
>>>>>>>>>>
>>>>>>>>>> Christos
>>>>>>>>>>
>>>>>>>>>> On Tue, Mar 24, 2015 at 7:38 PM, Stephen Mallette <
>>>>>>>>>> spmallette@gmail.com>
>>>>>>>>>> wrote:
>>>>>>>>>>
>>>>>>>>>> Hi Christos, we appreciate your offer to contribute. Could you
>>>>>>>>>> tell
>>>>>>>>>>
>>>>>>>>>>> us
>>>>>>>>>>> what kind of experience you have with TinkerPop so far? Are you
>>>>>>>>>>> at
>>>>>>>>>>> all
>>>>>>>>>>> familiar with the architecture/codebase?
>>>>>>>>>>>
>>>>>>>>>>> Stephen
>>>>>>>>>>>
>>>>>>>>>>> On Tue, Mar 24, 2015 at 11:47 AM, Christos Oikonomou <
>>>>>>>>>>> chrikon1994@gmail.com>
>>>>>>>>>>> wrote:
>>>>>>>>>>>
>>>>>>>>>>> Dear Tinkerpop Development Team
>>>>>>>>>>>
>>>>>>>>>>>>
>>>>>>>>>>>> My name is Christos Economou.
>>>>>>>>>>>>
>>>>>>>>>>>> I would like to contribute in the tinkerpop3.
>>>>>>>>>>>> This contribution will be a part of an assignment in one of my
>>>>>>>>>>>>
>>>>>>>>>>>> classes.
>>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>
>>>>>>>>>> I am in my third year of study at Athens University of Economics
>>>>>>>>>>>> and
>>>>>>>>>>>> Business (Greece | Hellas).In this semester I attend in lectures
>>>>>>>>>>>> that
>>>>>>>>>>>> called "Advanced Topics in Software Engineering" by professor
>>>>>>>>>>>>
>>>>>>>>>>>> Diomidis
>>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>> Spinellis.
>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>>> As assignment I have to contribute in an open source project. I
>>>>>>>>>>>> would
>>>>>>>>>>>> prefer to contribute to tinkerpop3. More specifically I
>>>>>>>>>>>> understand
>>>>>>>>>>>>
>>>>>>>>>>>> that
>>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>> in
>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>> big projects, like this, always exists work on integration and
>>>>>>>>>>>> collaboration between components and subsystems. So I do not have
>>>>>>>>>>>> any
>>>>>>>>>>>> problem to work on that. But I am more interested in creative
>>>>>>>>>>>> work
>>>>>>>>>>>>
>>>>>>>>>>>> like
>>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>> implementation of some algorithm or on a new functionality.
>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>>> I have to mention I have a hard constraint, that my contribution
>>>>>>>>>>>>
>>>>>>>>>>>> should
>>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>> be
>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>> at least 100 - 200 lines of code.
>>>>>>>>>>>>
>>>>>>>>>>>> So I am writing you to ask if you have in mind some
>>>>>>>>>>>> functionalities
>>>>>>>>>>>>
>>>>>>>>>>>> that
>>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>> I
>>>>>>>>>>>
>>>>>>>>>>> can help in development. Here some information about my
>>>>>>>>>>>> knowledge in
>>>>>>>>>>>> software engineering and programming languages
>>>>>>>>>>>>
>>>>>>>>>>>> http://altebaran.dmst.aueb.gr/FS/Students2012/chrikon/
>>>>>>>>>>>>
>>>>>>>>>>> inetpub/detfolio/.
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>> Thank you for your time and attention.
>>>>>>>>>>>>
>>>>>>>>>>>> Regards,
>>>>>>>>>>>> Christos Oikonomou
>>>>>>>>>>>> Assistant researcher at ISTLab
>>>>>>>>>>>> http://istlab.dmst.aueb.gr/content/members/m_chrikon.html
>>>>>>>>>>>> Github: https://github.com/xristosoik
>>>>>>>>>>>>
>>>>>>>>>>>>
>>>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>
>>>>>>>
>>>>>>
>>>>>>
>>>>
>>