Getting Started Contributing Back To Open Source
markfreeman writes "The one burning need I have felt over the last year was to get involved with open source as a contributor. I have wanted to help with documentation, advocacy, and most of all, with programming. Here's the story of how I got started, thanks to openhatch.org (which calls itself 'an open source involvement engine') and how you can too."
many people overlook the fact that the best thing we all can do for oss is to use it.
Actually, I'd say "most of all documentation".
Open source documentation is ass.
Hell, almost all technical writing is ass.
For all the buzz "Natural Language" interfaces get these days you'd figure someone would strive for a "Natural Language" manual. /irony is also "ass".
Ain't fun. Ain't sexy. Needs to be done.
"The problem with socialism is eventually you run out of other people's money" - Thatcher.
I checked out the site this guy is hawking, and their projects page lists just about every open-source project ever conceived!
Not every project... there's a curious lack of Java projects. But if you want to hack Python, boy are you in luck!
The biggest help I've gotten about OSS has been from knowledgeable folk on forums. (And I've never been the one asking the question)
Insanity: voting in the same two parties over and over again and expecting different results
And to add, something I'm missing in almost any documentation: write documentation that serves absolute beginners. Why? Because non-beginners already know how to use the [whatever]. So if they need more info, assume they're totally new to the subject you're documenting.
For example: so far I haven't found (online) a guide on 'how to use a computer, that has Ubuntu Linux on it' for beginners. How to configure Ubuntu: sure. What is different in Ubuntu vs. other distro's: sure. What is different in Linux vs. Windows: sure. But that's all documentation for people who are already experienced computer users. But a guide to using Ubuntu, for people who have hardly ever touched a computer: where? Show me. Let alone in localized versions...
Equally important: write docs to be read by users of the software first, not docs for co-developers. If developers need docs: do that later, but write the user documentation first. In fact, it wouldn't be bad to start a project by writing the user documentation first (and code later).