At the moment, I'm directly working with an open source project. (don't ask which) And incomplete documentation is not the only problem.I was working on a few source files for nearly a week and after that, I thought I'd try and push a patch out to the mailing list. I then get a reply telling me that main development was moved somewhere else MONTHS ago. The documentation was, to put it lightly, out-dated.
Frustrating does not begin to describe what I felt. :|
But, that is just
one bad memory. On the other side, I've had more than 10 good correspondences with the same project members.
The thing about open source projects, is even though the output of the good ones comes really close to a professional product, you must remember that, internally they are not managed that way.The key word here is
community. If you and your friends made a software project that you are willing to share, and host it on source forge, how would it look like? No doubt, you would be more than happy to have other, possibly more experienced people contribute code modifications to you, but will you take the time & effort to explain/teach them your code? Most of the time, the answer is NO.
That's the way open-source is. It's all about community. I'm not saying that they don't like newbies. In fact, they are usually welcomed with open arms. (I know I was!

)
What's NOT welcome are leechers. And it's difficult to distinguish between the two. The easiest way to set yourself apart from them, is to show that you have made some effort of your own to study and understand the code already posted out there. (Not many here will agree with me, but I found this :
How To Ask Questions The Smart Way VERY helpful)
If you plan to work on an open source project for your resume, then I'll tell you it's a good idea. BUT, this is going to require a LOT of discipline. What drives you will be your own will. There will be no-one to push you around telling you what to do.
What happens to most well-meaning people is that real life gets in the way and we end up postponing things. Like me, for instance. I've not updated the Free References Thread (link in my signature) for quite some time now. It's not that I've forgotten it or have no more new links to put up. (I actually have some python links I've been meaning to include for about 2 weeks now) What's happening is 2 things. a) I can't seem to get 1 hour of free time to do it and b) I want to keep the information in 2 posts, and NOT consolidate it into 1 post. I just can't figure out how to reply to that suggestion on the thread ...
But that's just me. For the rest of you, it's just an excuse. (I can read your minds, you see

)
-sigh- Looks like I've started ranting now.
Bottom Line: This is going to require a LOT of dedication, determination & discipline to make it work. Think you're upto it?