commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rogério Brito <rbr...@ime.usp.br>
Subject Re: [graph][PATCH] Getting started with graph-commons
Date Mon, 20 Jan 2014 00:11:43 GMT
Dear Benedikt,

On Jan 19 2014, Benedikt Ritter wrote:
> > Am 19.01.2014 um 17:34 schrieb Rogério Brito <rbrito@ime.usp.br>:
> 
> Hello Rogério, welcome to the dev ML!

First of all, thank you very much for the warm welcome. It always makes one
feel at home. :)

Secondly, I don't know what is the proper Apache etiquette and, as such, I
am including you in the CC. Please let me know if you prefer list-only
replies.

> > I am just re-learning Java (it's been a long time since I last used the
> > language) and an ex-student of mine (kinow) told me that there were many
> > projects hosted by Apache that were in need of contributors, especially
> > those that need some more domain-specific knowledge.
> 
> Nice that Bruno brought you here, helping hands are always welcome.

Yes, I am willing to help, but the barrier is the language, which I hope to
overcome.  As I said, when I stopped working with Java, the language (and
the library!) was quite smaller and I sill have to pick up generics and all
the fancy syntatic stuff.

> > I figured out that commons-graph would be a good place to start and I am
> > just reading the code (and trying to figure what is infra-structure from
> > what is real code), but, while doing that, I produced 3 test cases for an
> > issue in JIRA (which was opened Simone Tripodi).
> 
> I don't know about the current state of [graph], it has been a long time
> since I saw the last commit there. The problem here is, that Simone
> Tripodi, who was one of the main developers of graph hasn't been very
> active lately.

I saw. Bruno told me that he has not been active for a few months. :(

> I've always wanted to dig into graph myself, but never really found the
> time. I don't have a very deep background in graph theory, so I expect it
> to be pretty difficult for me to get working with the code base.

My background in Graph Theory is not too deep, but I am willing to learn.
Luckily, most of the algorithms that I saw mentioned and that are stubs I
have already studied at one point or another in my life.

The problem is really the language and I hope that you experts here can help
me sharpen my skills.  I've been mostly programming in Python, and in
relation to Python and other similar languages, Java is a bit on the verbose
side. :)

[About the Apache-way]
> >    https://issues.apache.org/jira/browse/SANDBOX-349
> > 
> > It is listed as Priority: Major and I guess that I can produce many more
> > (pathological or not) test cases and contribute back those tests.
> 
> I'll review your patch tomorrow evening (CET) and give you some feedback.

Thanks. I think that I can produce a semi-endless amount of examples/tests
here, but I stopped short of producing only three.

To put some things in context, I have the skeleton of a book on Graph Theory
(a draft of which I have sent to Bruno, BTW), but it is only in Portuguese,
alas.  Depending on how things go, I may even use commons-graph as the basis
for the non-mathematical parts of the book.

> We have git mirrors for most of our proper components [1] which are also
> been mirrored to github [2]. Maybe we can setup a mirror for graph as
> well, although it is a sandbox component.

I didn't know about git.a.o (I don't know if Bruno did also), and as I
didn't find one on github, I pushed a mirror to:

    https://github.com/rbrito/commons-graph

It is improperly created because I don't know (yet) the names of the persons
associated with their logins.

I will quite probably do it again (this time properly) and with the correct
attributions and tags/branches. The ones that are there were, essentially,
manually transferred and some tags look a bit weird. As I don't know if
they should be there in the first place, I think that some more human
intervention and guidance are needed.

If you feel like seeing things with pretty colors, then you may want to
check my patches at:

    https://github.com/rbrito/commons-graph/tree/rbrito

All commit messsages are more on the verbose side of things (as I regard a
VCS as a documentation tool also) and they have the standard Signed-off-by:
pseudo-header indicating my legal agreement.

> > Would anybody be interested in such contributions?
> 
> Patches are always welcome! If you intend to get involved it would be good
> if you could file an Individual Contributor License Agreement [3]. It
> makes things a lot easier.

Thanks. I just did that and sent the signed document to secretary@a.o. What
are the next steps?


Thanks a lot for the hints,

Rogério.

-- 
Rogério Brito : rbrito@{ime.usp.br,gmail.com} : GPG key 4096R/BCFCAAAA
http://cynic.cc/blog/ : github.com/rbrito : profiles.google.com/rbrito
DebianQA: http://qa.debian.org/developer.php?login=rbrito%40ime.usp.br

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Mime
View raw message