This document provides tips for joining and contributing to an open source community. It discusses communicating effectively in open source projects, which typically involves participating in mailing lists and IRC channels rather than private messages. The document also addresses how to get acclimated to a new community by lurking first, finding ways to help out such as testing or improving documentation, and tips for submitting code contributions through processes like request for comments.
Unraveling Multimodality with Large Language Models.pdf
Q4.11: Participating in the Linaro community
1. Tips for joining and contributing to
an open source community
Tips for joining and contributing to
an open source community
Participating in the Linaro CommunityParticipating in the Linaro Community
4. Communication is DifferentCommunication is Different
●
Proprietary
●
One to One/Few
●
Instant messaging / Targeted Emails
●
Open Source e-mail etiquette
●
Open Source
●
One to Many
●
IRC Channels / Mailing Lists
●
“I didn't realize how important IRC and BIP were”
5. Tixy's Tips for Saying “hi”Tixy's Tips for Saying “hi”
●
Lurking
●
Studying
●
Find your opening
6. Working From HomeWorking From Home
●
Scheduling
●
The Daily Routine
●
Physical Organization
●
Avoiding Distractions
●
Managing E-mail
●
Leave Your House!
7. The Learning CurveThe Learning Curve
●
Linaro encompasses a lot (kernel, ubuntu,
android...)
●
Help may not be face to face
8. Finding ThingsFinding Things
●
Finding who's who:
●
https://wiki.linaro.org/MeetTheTeam
●
Finding things on the Wiki:
●
CategoryHowTo
●
Search (text and title)
●
Google site search
●
Searching old mailing list archives
●
site:lists.linaro.org/pipermail/linaro-dev pre-built images
andy
9. How You Can HelpHow You Can Help
●
You don't have to be in Linaro to help
●
http://www.linaro.org/community/
10. How You Can HelpHow You Can Help
●
Testing images:
●
http://lists.linaro.org/pipermail/linaro-
dev/2011-September/007817.html
●
Help improve the wiki
●
Answer questions on Ask Linaro.
●
File a bug – even better include a patch
Work on ER team. Two goals help new engineers and help community.
This was inspired by Paul M and Tixy.
Also got ideas from Zach P, James T, Jesse B
They all spoke about common problems that happen when you go from proprietary to opensource.
Introduce each other
I've used Linux since 1998, but after working at IBM for 11 years on everything from J2EE to embedded. I was in for surprises when I joined Linaro
One of the hardest things to do when joining a community like Linaro can be simply saying “hi”.
Not necessarily the first “hi”, but the first real time you need to communicate.
There's a few reasons:
* intimidating – my 4th day involved speaking for 10 minutes on Git. There were git experts in the crowd.
* how to even do it, ie email/irc/bug-report
In small companies and even my experience at an extremely large company, communication is limited to small audiences.
At linaro much of the communication is one-to-many. You're no longer sending an instant message to bob or a build-team. You're now talking on a large mailing list or IRC channel.
Email etiquette: https://fedorahosted.org/rhevm-api/wiki/Email_Guidelines
Tixy is a great example of how to get involved in a community. He started as a community member we didn't know, and now works for Linaro.
He started by lurking on the mailing lists and IRC channels. Meanwhile he studied the websites. Specifically wiki.l.o. He focused on the area of a specific engineering team.
Then started listening in to weekly irc meetings etc.
Find your opening and email the Tech
Lead of the relevant team with a quick introduction and offer to help.
You may not be fortunate enough to get your pick of things to work on but there will likely be tasks you can help on, or new related work that you could suggest.
https://wiki.linaro.org/Internal/Resources/WorkingBetterFromHome
In short: treat it like a job
Maintain consistent work hours so people know when they can find you
Treat it like going to the office. eg put on clothes
Try to have a real workspace. Don't work from your bed. Ergonomics
E-mail – use filters to help deal with mailing list volumes
Importance of getting out
http://www.linaro.org/getting-started - several use cases (kernel, toolchain, android, etc)
We've got topics like “linaro-general-restructuring-the-linaro-web” and “wiki madness”
If you are just started visit linaro.org/community
I put Homer Simpson on this slide because ...
https://wiki.linaro.org/WikiVideo/
Title: panda
By Text: blueprint naming conventions
Site search: blueprints
Now that you've figured out how to say hi and how to find things you are ready to help!
Key take-away: anyone can help
This may be the most different thing about open source of all.
Keep in mind: Most likely people won't know you. You'll have to earn their trust.
Open source projects like the kernel have their source read MUCH more than it is written, so readability is really stressed.
Many companies, even when code is reviewed, allows submissions of big changes in a single chunk. Open source code reviewers like submissions to be a series of small chunks. Bisectability
You will inevitably wind up doing more than one revision so plan for it in your dev-env from the start. Don't worry even top contributors go through multi-revisions sometimes