PublicLab.org and PL's other open source software is written, maintained, and dreamed up by commu...
Public Lab is an open community which collaboratively develops accessible, open source, Do-It-Yourself technologies for investigating local environmental health and justice issues.
Public Lab chatroom
Reset your password
Read more: publiclab.org/n/13687
PublicLab.org and PL's other open source software is written, maintained, and dreamed up by community contributors, just like the techniques you see on PublicLab.org itself. While you can read about our software development projects at https://publiclab.org/wiki/developers, we know not everyone can jump into being a code contributor -- but we also know there are lots of other ways you can help out, even without taking on a coding task.
And with our recent work in recruiting first-timer code contributors generating exciting growth in our software contributor group, we're looking to define clear ways others can get involved in more of a supportive role.
I've looked at some of the ways people have played a valuable supportive (or mentoring) role -- like in our #gsoc program each summer -- and found that some don't take a huge amount of time or commitment, but can really make a difference. Here are a range of different types of involvement -- and keep in mind that many people do a combination of these:
(forgive my slightly corny naming system!)
The key here is that:
For example -- a Reviewer might do a lot of good just by checking in once a week to look over current pull requests, to see if they're missing anything, or make any obvious mistakes. This could be just a calendar reminder at the 15-20m you know you'll have free each Friday, say.
A Connector might check in once daily but only for 10 minutes, just to thank new people for their involvement, or to encourage them to open a pull request with their latest code if they get stuck (so others can check on their work and offer help).
A Community rep can offer their knowledge of how the PL community works (or doesn't!) without having to know anything about coding. They context to a bug or purpose for a feature request.
And so on. What's helpful for me, to match you with a role, is to know:
And keep in mind, this is a bit of an experiment! We'd love to better connect the PL community with our quickly-growing software contributor community, and this is just one way we're hoping to help.
Read on to learn more about each role, and volunteer in the comments if you'd like to get plugged in!
We'll be creating a "team" for each of these on GitHub (https://github.com/orgs/publiclab/teams); on there, you can notify each by typing @publiclab/teamname in a comment. So please share your GitHub username with us in the comments to sign up!
(Illustrations/mascots sought for each these, haha)
@publiclab/solvers - Everyone gets stuck sometimes, and some people are just good at teasing out what went wrong. If you're particularly familiar with Ruby on Rails, or with a specific portion of our codebase, this could be you! No obligation to actually fix problems, but just to take a look and suggest a way forward, or a way to test assumptions and debug. We especially think writing tests is a great way to debug!
Availability: we'll ping you with a @publiclab/solvers mention, or you can just look at recent pull requests; maybe once every week or two. Unsubscribe from project-wide notifications!
Variation: Pre-schedule time each week or month to check in on recent pull requests and review code for problems and style/structure. We've told contributors that reviews happen on Tuesdays and Fridays, so these are good times to check i, and look specifically at the "Files changed" tab of each PR to read through submitted code. You can:
For pre-scheduled solving, consider setting your project notifications (see below) to Ignore so that you don't get any emails, and just check in on your own schedule!
@publiclab/connectors - Often, it makes a big difference to newcomers to simply hear some encouragement and thanks, both in response to comments like "Can I try to fix this one?" and after a fix is completed, say, in a tweeted thank-you. To do this, look for newcomers in recently updated issues or subscribe to notifications for the whole project and look out for people asking to get involved. Even if you're just saying hello to people, and offering encouragement, that's a lot of help -- you don't need to code to do this!
If you can help people find documentation, tutorials, or Stack Overflow pages to guide them, that's really helpful too! We've also heard from some contributors that it's really helpful to have a real live person (via chat, for example) there to say hello, even if all they do is be friendly and point people at the right resources.
Availability: this is the most day-to-day kind of work -- it's helpful to reply quickly to newcomers with a welcoming hello -- though the message can be "saved reply" to make this quick (see below). And beware -- the project-wide notifications can be high-volume. You shouldn't have to actually spend lots of time with anyone in particular, but it'd be great if folks already on IRC could just keep an eye out for newcomers asking questions.
@publiclab/community-reps - It's difficult for newcomers to really understand the complexities and context for different site features, so we'd love to have some people just explain why features or systems are important, and how they're used. You don't need to know anything about software for this one -- it's just helpful to link to where on the site a feature would show up, and help new coders understand what their contribution will mean.
Availability: Once a week or so, we'll mention @publiclab/community-reps to notify you of where you could be of assistance. Unsubscribe from project-wide notifications!
There are some important tools available to help you be a good code mentor or helper:
So, again, just leave a comment below with your GitHub name to join a team, and feel free to ask questions or make suggestions!
And finally, if you find it's too much, please don't hesitate to take a break or withdraw! We definitely don't want to overload people and we very much understand that everyone's got a lot going on in their lives!
I did this Help out by offering feedback!
None yet. Be the first to post one!
I'm going to start small with 5-15 min/week. I'm interested in mapping and connecting current and existing citizen projects. @wvward on Github
That's great, Will - thanks! From the "types" listed above, was there a group you'd be interested in joining? I can add you to the project as appropriate if that's helpful.
But also, if you want to do some mapping stuff, there's one issue here which I was hoping to reformat into a first-timers issue, and I could do that soonish if you'd like to tackle it?
It's small, but it's an important step forward!
Is this a question? Click here to post it to the Questions page.
Hi, Will -- here's another related to mapping: https://github.com/publiclab/plots2/issues/1026 -- happy to help you get set up!
Hi, Jeff -- I'd like to contribute to #1026. I'll comment more on github for that issue.
And for a role: Could I be a reviewer? I may learn more by reviewing other contributor's code.
Just wanted to note (as mentioned in the latest web working group report, that we now have a "reviewers" group with 4 people -- a great start!
Hi, all - beginning to incorporate some of these ideas into a concrete "tasks" listing and a kind of welcome page for those helping lead our software community, here:
"Help organize and lead the community" -- https://github.com/publiclab/plots2/projects/4
It's a bit similar to the newcomers welcoming page!
Just a note that I pasted in some more guidance on being a reviewer over here: https://publiclab.org/wiki/developers#Reviewers
Mentoring for Summer of Code programs has a lot in common with being a software "reviewer" with Public Lab throughout the year; to welcome and support our community of coders, we need to:
Some specific things you can do:
@warren i would love to be a part of the connectors team and i can help with the image-sequencer project, my github username is tech4gt
Hi, @tech4gt -- I'm going to add you to the reviewers group for now, as that's the only active one at the moment (although we're probably going to expand soon as it's becoming busy!) Is that OK?
We'd be happy to have your help with connecting via that group :-)
There are now 9 teams!
@warren yeah that's completely fine, thanks and sorry for late reply i just saw this:-)
You must be logged in to comment.
This is marked this as an activity for others to try.
Try it now
Click here to add some more details.
How long does this activity take?
How hard is this activity?
What kind of activity is it?
What is it's current status?