On 19/10/2010 10:31, James Gough wrote:
Hi Dan,
[snip]
I was thinking that some documentation might be a good thing for me to
get stuck into to start with just to write about how things are
working and also check out the code base and play around with that
too.
In an ideal world I think that'd be a good idea. However, right now our
docs are in a bit of a state, as various discussions on isis-dev have
pointed out [1]. As soon as I get the NOF codebase building cleanly, my
next stop is to sort out those docs. So I'm not sure we're in a
position to get some help there just yet.
Another point that we do need to bear in mind is the "Apache Way"...
before you can get full permissions ("karma" in the ASF jargon) to
commit, you need to show willing by contributing some patches via JIRA.
So this says we should try to find something you could work on that'd be
interesting, but relatively discrete.
What would your advice be for getting stuck in? I'm also monitoring
the mail traffic.
One thing we really need to do is to improve our test code coverage, and
so you might want to consider writing some unit tests for the applib.
If you use EclEmma then it's pretty easy your code coverage in Eclipse.
And getting exposure to the applib would be good starting point. It
would also be a nice, discrete piece of work on part of the codebase
that's very stable (so easily patchable).
Alternatively, there are lots of active tickets on our old bug-tracking
system [2]. However, I've not been through them recently and some/many
could be redundant. I wouldn't want you to tackle something, get
frustrated, then give up. But some you could consider picking up any of
[3] ~ [7]
Or, another idea (and something that Dave Slaughter was also thinking of
doing) is to do some screencasts, eg using Jing. That would be a good
way of documenting where you are up to (and make for a couple of good
blog posts too). There's some ideas on the wiki [8]; you could always
grab one and post to isis-dev that you're working on it.
[1]
http://mail-archives.apache.org/mod_mbox/incubator-isis-dev/201010.mbox/%[email protected]%3e
[2] http://development.nakedobjects.org/trac/report/1
[3] http://development.nakedobjects.org/trac/ticket/82 - JScience values
[4] http://development.nakedobjects.org/trac/ticket/247 - applib day names
[5] http://development.nakedobjects.org/trac/ticket/584 - metamodel
validation
[6] http://development.nakedobjects.org/trac/ticket/601 - @ReturnedNamed
[7] http://development.nakedobjects.org/trac/ticket/612 - applib date times
[8] https://cwiki.apache.org/confluence/display/ISIS/ScreencastIdeas
James
Cheers
Dan
