Quote from: redman at Jan 24, 2009, 06:13 AM
the problem for me though is that there isn’t clear enough design documentation (or if there is, i haven’t found it).
I agree 100%; the problem is I am terrible at producing useful design artifacts. I think some kind of collaboration is essential to solve this problem; someone with interest and skills in interpreting my abstract descriptions and turning them into useful documentation would be invaluable to the project at this point. That person has just never materialized.
That said, I will do my best to produce some useful artifacts to help resolve this situation as best I can in the meantime.
Quote from: redman at Jan 24, 2009, 06:13 AM
also, issues in jira don’t have any indication of how they should be solved.
I agree it would be nice if everyone submitted solutions with their problems, but is that realistic? Even I don’t know how I’m gonna solve something until I get into the process of researching, refactoring and testing.
Quote from: redman at Jan 24, 2009, 06:13 AM
i appreciate that with only a handful of developers working on the code it might seem to make more sense to concentrate on coding instead of documenting, but i think that by making it easy for people to contribute, more people will be encouraged to do so. i’m sure i could chat to you guys on irc about development issues, but we’re in different timezones and it might not be convenient.
Forums, IRC, IM, Skype, Crucible code reviews, whatever it takes; I still say collaboration is essential whatever the form it takes, and we have the tools available. We just need the willingness of more folks to get intimately involved more frequently.
Quote from: redman at Jan 24, 2009, 06:13 AM
what i’m suggesting is that we spend a bit of time setting things up to make it as easy as possible for people to contribute. if i could check jira and see a bug, and it had a description of the issue along with a top-level suggestion (or detailed instructions) of how to fix it, i’d feel confident spending time working on it, and that the way i fixed it was inline with the overall design goals.
This problem goes back to collaboration (even if in the Jira comments) and the conveying of design goals; once we resolve that I think this is less of an issue. Let’s focus on solving the central design conveyance issue, as I believe that is a more important and tangible goal.
Quote from: redman at Jan 24, 2009, 06:13 AM
occasionally revolution has changed its course while i’ve been monitoring it, which has discouraged me because i don’t want to spend time working on something that isn’t going to make it into the code.
Voice your concerns over whatever refactorings are going on and we’ll be glad to address that head-on. As this is pre-initial release of this product (I consider this a complete rewrite), I’d rather have all major refactorings done before beta release, and this is why some bigger changes have been taking place. This will stabilize a little in this release cycle, and even more as the releases mature past the first few.
Quote from: redman at Jan 24, 2009, 06:13 AM
surely i can’t be alone in feeling like this amongst the community - and this may lead to the perception that people just want to take instead of contribute, when in actual fact, it’s (in my perception) too difficult to contribute.
No, you are spot on with your observations and I’m sure they will help us create a more productive environment for contributors. Thanks for voicing these thoughts.