Such as?Geoff the Medio wrote:There are other SVN clients besides TortoiseSVN.Zireael wrote:I had issues with Tortoise SVN and had to deinstall it, so no downloading from SVN repo
Newcomers! What's confusing about Contributing to FreeOrion?
Re: Newcomers! What's confusing about Contributing to FreeOr
- Geoff the Medio
- Programming, Design, Admin
- Posts: 13587
- Joined: Wed Oct 08, 2003 1:33 am
- Location: Munich
Re: Newcomers! What's confusing about Contributing to FreeOr
I'd agree with RonaldX's post on page 1, having spent the last couple of weeks looking at FreeOrion and considering getting involved. The sheer volume of material, particularly on the forums, is pretty overwhelming, and takes an awful lot of reading.
I'd suggest a few things:
a) For some of the material, perhaps forum threads are not the best place? I've perhaps not completely validated this suggestion, but I suspect that an evolving Wiki page would be an easier way to capture some of the complex and evolving ideas that FreeOrion is currently tackling in the forum. By all means have discussions in the forum, or on IRC or wherever, but after the dust has settled, someone could periodically distil the main ideas into a Wiki page (which can be a great deal denser and better structured, than 6 pages of forum posts spanning many years, and containing ideas that have been discarded or changed, alongside nuggets of current design or future development
b) I'm increasingly getting the feeling that a clearer roadmap to v1.0 is needed, to give the whole think more of a sense of direction. As it is, I'm struggling to avoid a sense that there is an overwhelming volume or work and time required, and that any contribution may never see the light of day in a playable game (or at least that I'm unlikely to make it to my FO Diamond Jubilee, and be in any position to leap up and cheer "completion" )
c) Perhaps a periodic (monthly?) summary post, or email, or something, summarising what's been changed, who's joined and left various teams/tasks, what new problems or topics need attention, might help to focus current and potential contributors on what's currently happening and what really matters, so that they can avoid getting bogged down in (sometimes unneccesary) detail
d) Finally, I wonder whether more focussed teams could be formed, to tackle certain aspects of the game? As it is, I've seen frequent mention of "Design", and the "Design Team", Programming, and Content Creation, but perhaps these 3 categories are insufficient? Could the overall task be broken down into some sort of hierarchy, and experienced contributors volunteer to lead each significant chunk of work? I'm sure this happens to some degree, but to me it is certainly not sufficiently clear who I should talk to, or where I should post, about getting involved with certain aspects of the game.
I must of course add that, despite the challenges, what has been done so far is very impressive, and surely holds great promise. I hope that v1.0 can be achieved in the coming years, and sufficiently meets the expectations of enough people to be counted a success.
I'd suggest a few things:
a) For some of the material, perhaps forum threads are not the best place? I've perhaps not completely validated this suggestion, but I suspect that an evolving Wiki page would be an easier way to capture some of the complex and evolving ideas that FreeOrion is currently tackling in the forum. By all means have discussions in the forum, or on IRC or wherever, but after the dust has settled, someone could periodically distil the main ideas into a Wiki page (which can be a great deal denser and better structured, than 6 pages of forum posts spanning many years, and containing ideas that have been discarded or changed, alongside nuggets of current design or future development
b) I'm increasingly getting the feeling that a clearer roadmap to v1.0 is needed, to give the whole think more of a sense of direction. As it is, I'm struggling to avoid a sense that there is an overwhelming volume or work and time required, and that any contribution may never see the light of day in a playable game (or at least that I'm unlikely to make it to my FO Diamond Jubilee, and be in any position to leap up and cheer "completion" )
c) Perhaps a periodic (monthly?) summary post, or email, or something, summarising what's been changed, who's joined and left various teams/tasks, what new problems or topics need attention, might help to focus current and potential contributors on what's currently happening and what really matters, so that they can avoid getting bogged down in (sometimes unneccesary) detail
d) Finally, I wonder whether more focussed teams could be formed, to tackle certain aspects of the game? As it is, I've seen frequent mention of "Design", and the "Design Team", Programming, and Content Creation, but perhaps these 3 categories are insufficient? Could the overall task be broken down into some sort of hierarchy, and experienced contributors volunteer to lead each significant chunk of work? I'm sure this happens to some degree, but to me it is certainly not sufficiently clear who I should talk to, or where I should post, about getting involved with certain aspects of the game.
I must of course add that, despite the challenges, what has been done so far is very impressive, and surely holds great promise. I hope that v1.0 can be achieved in the coming years, and sufficiently meets the expectations of enough people to be counted a success.
--Steaker--
Re: Newcomers! What's confusing about Contributing to FreeOr
The design team (including content creation) is Geoff, eleazar and me. The art team is pd and eleazar, and the programming team is Geoff and tzlaine (though I'm moving more towards this category, and tzlaine has been largely inactive for a while). The music team is effectively me and 93143, though both of us are mostly inactive in that area atm. If you want to know anything about contributing to programming or game design, talk to Geoff. If you want to know anything about contributing to art, talk to pd, or eleazar if it's not about 3d models. If you want to know anything about contributing to music, talk to me or Geoff.Steaker wrote:d) Finally, I wonder whether more focussed teams could be formed, to tackle certain aspects of the game? As it is, I've seen frequent mention of "Design", and the "Design Team", Programming, and Content Creation, but perhaps these 3 categories are insufficient? Could the overall task be broken down into some sort of hierarchy, and experienced contributors volunteer to lead each significant chunk of work? I'm sure this happens to some degree, but to me it is certainly not sufficiently clear who I should talk to, or where I should post, about getting involved with certain aspects of the game.
(Does that sound about right, everyone?)
So yeah, long story short, there aren't really enough people at the moment to split into more "focused" groups.
I do agree though, that some sort of summary of what's going on from everyone might be useful, a la Agile Development. Like once a week, everyone posts in a thread what they did last week and what they plan on doing the following week, or something like that. That way, just checking out that thread would be a good way of seeing what's current in development. Likewise, "Iteration"-wise planning might also be useful, for instance this "iteration", we plan on completing the transition from food to growth and eliminating minerals, for example. Of course when the amount of time any given contributor has to work on the project is so volatile, the the idea of a fixed timeframe for completing stuff completely goes out the window, and the concept of what an "iteration" is becomes hazy...
Better documentation of game design ideas, such as on the wiki, would be nice, but a bit time consuming to maintain - and of course the time that we can actually put into the project, we usually prefer to use to actually get stuff done, since there's little enough of that going on as it is...
Warning: Antarans in dimensional portal are closer than they appear.
- eleazar
- Design & Graphics Lead Emeritus
- Posts: 3858
- Joined: Sat Sep 23, 2006 7:09 pm
- Location: USA — midwest
Re: Newcomers! What's confusing about Contributing to FreeOr
I consider pd currently inactive -- August is the last time he did more than make a brief response to an occasional post.
As for me, i couldn't resist the sale and bought Civ V last weekend, so FO has some serious competition for my game making/playing time for a while.
Yeah, i know this project is a real pain to follow, but with our size, adequately documenting and explaining as we progress would take a significant portion of development time. I'm not saying we have hit the prefect balance
One thing we haven't done this year is use the "Game Design" forum -- which probably would help signal which topic are "officially" being worked on.
We're usually good about writing descriptive messages for the commits, which can be seen various places, such as here: https://github.com/freeorion/freeorion/commits/master/
But if it is any comfort development has been faster this year than every before in my 6 years -- in part because the scripting engine has been refined to the point where non-coders can really help move things along.
You'll usually get answers pretty quick. And if you demonstrate followthrough and do something useful you'll have distinguished yourself from 90% of those who volunteer to help.
As for me, i couldn't resist the sale and bought Civ V last weekend, so FO has some serious competition for my game making/playing time for a while.
Yeah, i know this project is a real pain to follow, but with our size, adequately documenting and explaining as we progress would take a significant portion of development time. I'm not saying we have hit the prefect balance
One thing we haven't done this year is use the "Game Design" forum -- which probably would help signal which topic are "officially" being worked on.
We're usually good about writing descriptive messages for the commits, which can be seen various places, such as here: https://github.com/freeorion/freeorion/commits/master/
We used to have one that laid out everything in 10 discrete stages. Unfortunately we got tangled up for about a year trying to follow that order though it became counterproductive. So we ditched it for a more fluid approach where we choose the next thing as seems best when it is time to do the next thing.I'm increasingly getting the feeling that a clearer roadmap to v1.0 is needed
But if it is any comfort development has been faster this year than every before in my 6 years -- in part because the scripting engine has been refined to the point where non-coders can really help move things along.
Just make a post: "Hey, i think i could improve X by doing Y. Any objections? Anything i should know?"...but to me it is certainly not sufficiently clear who I should talk to, or where I should post, about getting involved with certain aspects of the game.
You'll usually get answers pretty quick. And if you demonstrate followthrough and do something useful you'll have distinguished yourself from 90% of those who volunteer to help.
Re: Newcomers! What's confusing about Contributing to FreeOr
Yes, I'm inactive. I've informed Geoff about it in September last year. I'm still peeking in once a week or so, but won't be able to do anything. I've graduated a couple of weeks ago and am now working full time.eleazar wrote:I consider pd currently inactive -- August is the last time he did more than make a brief response to an occasional post.
- eleazar
- Design & Graphics Lead Emeritus
- Posts: 3858
- Joined: Sat Sep 23, 2006 7:09 pm
- Location: USA — midwest
Re: Newcomers! What's confusing about Contributing to FreeOr
Congratulations!pd wrote:I've graduated a couple of weeks ago and am now working full time.
Once things settled down i found life after graduation less hectic in general, but your milage may vary.
Re: Newcomers! What's confusing about Contributing to FreeOr
I've just ordered a new Core i5 machine, which should be OK for building FO - the current old clunker is struggling
I've a mind to have a look at the AI - having played a few games, its a shame that the computer players don't seem to leave their home systems. I appreciate that it probably can't be properly finished until other features are more stable, but it does seem to me that elements could be improved in the meantime.
Alternatively I could have a go at refreshing the Wiki, if that would be helpful?
Or, though my background is in Embedded C and Java, I'm sure I could have a go at some bug fixing or whatever is needed to help get the project to the next milestone (v0.5 I guess?)
Either way, seems like there's a really great foundation of code, content, and dedicated people here, I hope it can turn into
I've a mind to have a look at the AI - having played a few games, its a shame that the computer players don't seem to leave their home systems. I appreciate that it probably can't be properly finished until other features are more stable, but it does seem to me that elements could be improved in the meantime.
Alternatively I could have a go at refreshing the Wiki, if that would be helpful?
Or, though my background is in Embedded C and Java, I'm sure I could have a go at some bug fixing or whatever is needed to help get the project to the next milestone (v0.5 I guess?)
Either way, seems like there's a really great foundation of code, content, and dedicated people here, I hope it can turn into
--Steaker--
- eleazar
- Design & Graphics Lead Emeritus
- Posts: 3858
- Joined: Sat Sep 23, 2006 7:09 pm
- Location: USA — midwest
Re: Newcomers! What's confusing about Contributing to FreeOr
All three of those are needed, take your pick!Steaker wrote:I've a mind to have a look at the AI - having played a few games, its a shame that the computer players don't seem to leave their home systems. I appreciate that it probably can't be properly finished until other features are more stable, but it does seem to me that elements could be improved in the meantime.
Alternatively I could have a go at refreshing the Wiki, if that would be helpful?
Or, though my background is in Embedded C and Java, I'm sure I could have a go at some bug fixing or whatever is needed to help get the project to the next milestone (v0.5 I guess?)
Re: Newcomers! What's confusing about Contributing to FreeOr
I'll have a good look at the AI, and brush up my Python. Who should I talk through potential changes with?
I think I would need to be given an account, to make changes to the Wiki?
Once I get building successfully on my new machine, I'll have a look for any bugs, and see if I can make any progress. I'm guessing this might be the most tricky for now, until I'm more familiar with the code and what's being changed at the moment
I think I would need to be given an account, to make changes to the Wiki?
Once I get building successfully on my new machine, I'll have a look for any bugs, and see if I can make any progress. I'm guessing this might be the most tricky for now, until I'm more familiar with the code and what's being changed at the moment
--Steaker--
- Geoff the Medio
- Programming, Design, Admin
- Posts: 13587
- Joined: Wed Oct 08, 2003 1:33 am
- Location: Munich
Re: Newcomers! What's confusing about Contributing to FreeOr
Make a post on the programming forum. There already is a good deal of AI code, but it's probably just failing when making a call that leads to an error due to recent changes. There should be some indication of this in the AI log files.Steaker wrote:I'll have a good look at the AI, and brush up my Python. Who should I talk through potential changes with?
Yes; a wiki account is required to edit, and public registration is disabled. If you want a wiki account, send me a private message on the forums with a desired username and an email address to register the account with.I think I would need to be given an account, to make changes to the Wiki?
Re: Newcomers! What's confusing about Contributing to FreeOr
It is. The AI code is throwing an exception when trying to reference the food resource. I haven't tried a new build now with minerals removed, but I assume referencing the mineral resource will throw an exception now too...Geoff the Medio wrote:...There already is a good deal of AI code, but it's probably just failing when making a call that leads to an error due to recent changes. There should be some indication of this in the AI log files...
Re: Newcomers! What's confusing about Contributing to FreeOr
I've managed to download, build, and run (all be it rev 4891 seems to have a tech tree issue)
I'll go ahead and have a look at the AI logs, and see if I can make some helpful adjustments to the AI to get it around the food and mineral changes
I'll go ahead and have a look at the AI logs, and see if I can make some helpful adjustments to the AI to get it around the food and mineral changes
--Steaker--
Re: Newcomers! What's confusing about Contributing to FreeOr
I think you already nailed one of the most important ones: the fact that a lot of the 'shell' of the project is horribly outdated. Perhaps we should see if we can get some of the regulars, that do not otherwise contribute, overhaul the wiki and make sure it keeps linking to up-to-date files and information. (For instance for at least a year or more, to get a recent build of the project you had to know exactly where to go on the forums, and then go through several installations, just to install! This isn't that horrible, but it'd be nice if this information was all concise and available at a single point).
Other than that, I think the front page may need an overhaul. Is there any particular reason we're having it start on the wiki?
Other than that, I think the front page may need an overhaul. Is there any particular reason we're having it start on the wiki?
- Geoff the Medio
- Programming, Design, Admin
- Posts: 13587
- Joined: Wed Oct 08, 2003 1:33 am
- Location: Munich
Re: Newcomers! What's confusing about Contributing to FreeOr
Could you be more specific? What information / pages need overhauling?Sai wrote:the 'shell' of the project is horribly outdated.
I'm not sure what you're referring to here... The latest numbered release is always linked from the main page of the wiki. Test releases aren't meant for everyone, but even those are also linked from the main page...For instance for at least a year or more, to get a recent build of the project you had to know exactly where to go on the forums...
What do you mean by that?...and then go through several installations, just to install!
All what information?This isn't that horrible, but it'd be nice if this information was all concise and available at a single point).
Is there any reason it shouldn't? What else would it be?Other than that, I think the front page may need an overhaul. Is there any particular reason we're having it start on the wiki?