On 17.08.2012 16:56, Ola Sundell wrote:
> Hello.
>
> I love playing Freecol and since I work as a Java developer, I wanted 
> to see if I could help.  It has been a while since I last contributed 
> code to an open source project, but I'm keen to give back to the 
> community - especially to a game which has given me hours of enjoyment.
>
> I've fixed a small thing that has been annoying me: when I remove a 
> trade route stop the selection is removed from the list and I have to 
> click in the list box anew. Where do I submit a patch for it?

New contributors are always welcome. Please just send your patch to the 
mailing list. As far as your suggestions for improvement are concerned, 
I must agree with my fellow developers:

>
> I've been peeking at the code base and I ran a Sonar run just to do a 
> health check. Thus far, this is what I've seen:
>
> Good Things(tm):
>
> * short but sweet methods
> * pretty well-structured packages
> * compiling works out of the box
> * you've avoided Maven (hooray!)
> * quite a bit of javadoc for the public methods
>
> Smells:
>
> * Huuuge classes (InGameController is 3866 lines! Yikes!!!)

I don't think line count alone is indicative of a problem. If the class 
can be split into several in a sensible manner, by all means go ahead, 
but I don't see any obvious fault lines. Some helper methods could be 
moved elsewhere, but I don't really see the benefit.

> * Old-ish versions of external libraries
> * Code coverage could be a little bit better

Definitely. New unit tests are always welcome. The GUI, in particular, 
is in need of some automated testing, but this is notoriously difficult.

> * A bit of code duplication here and there.

This should definitely be eliminated.

>
> All together I would say that from what I've gathered thus far, the 
> code base is in very good shape would it not be for the gigantic 
> classes. I humbly ask for permission to start refactoring - would that 
> be of interest? I would primarily look at breaking those huge classes 
> apart.
>
> Best regards and warm wishes and huggies
>
> Ola

I hope our lack of enthusiasm hasn't offended you. We certainly could do 
with more contributors, but bug fixes, unit tests, new features, 
small-scale code cleanup and improved documentation would be more 
welcome than any large-scale refactoring.

Regards

Michael


------------------------------------------------------------------------------
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
_______________________________________________
Freecol-developers mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/freecol-developers

Reply via email to