Needs Love

Posted by Vanessasaurus on March 11, 2020 · 8 mins read

This is a crosspost from VanessaSaurus, dinosaurs, programming, and parsnips. See the original post here.

Have you ever found that learning is most fun when you are working on something that you care about? I’ve most definitely realized over the years that I best learn when I’m working on an actual problem. For much of this learning I’m on my own, and in very rare cases I get to work on a project that someone else cares about, and working together (or individually with support) is amazingly fun. So - how do we do more of that?

Needs Love

I would bet that you can iterate over a conference room of people, and every single person would have at least one project or idea that they were wanting to work on, but just didn’t have the time. This is the goal of a new project that I’ve started called needs love.

Specifically, it’s a simple repository where you can post an idea or project that needs a little love, or you can go to find one. The goal is to be able to match research software engineers with projects that need them. I hope that it could be a small peer-to-peer network for learning by way of doing. It’s based off of the good first issues action and interface, but scoped and branded for needs-love issues posted directly to the repository.

If you are interested, there are also GitHub actions set up to do simple label management. When an issue is labeled with “needs-love” it is added to the web interface nightly, and when the “matched” label is added to indicate that someone is going to work on the issue, the needs-love label is removed.

What Needs Love?

You might feel overwhelmed or frustrated by a lack of time to finish some of your projects, but have you ever thought about the opportunity that such unfinished work offers? For research software engineers that don’t work in a group, or largely exist in silos, finding consistent sources of challenge is a challenge in and of itself. And guess what - an unfinished project and an RSE hungry to learn is a match made in heaven. If you are submitting a project or idea as an issue, you get it rolling again, and the RSE has an opportunity to grow. This is a problem I find myself continually in - hence why I embark on so many seemingly random projects.

In a nutshell, both the projects and the RSEs need a little love.

Who is Involved?

I wouldn’t pass up a chance to make a bread metaphor, so here we go!

Starters

We aren’t talking about bread, folks, but the pun is quite lovely. A starter has put some time and thought into a recipe, and very likely started the baking process, but doesn’t have the bandwidth to finish the dough and put it in the oven.

What makes a good starter?

A good starter has expertise in some area, or a project started, but doesn’t have time to finish up. It’s also okay to just have an idea that you want to throw out there for someone to work on. You might not even know what the best implementation might be! Thus, a good starter can also just have a good idea.

Finishers

Finishers are hungry for opportunity, and fun projects. A finisher can be very independent and curious, or ask for a bit more help. The finisher wants to take some project that has been started, and turn it into delicious bread, or an idea that isn’t baked yet, and write the recipe.

What makes a good finisher?

The finisher, regardless of skill, should be motivated to take ownership of a project or an idea.

Submitting a Project or Idea

You can submit a project or idea that needs love simply by opening an issue, and selecting the “Project or Idea that needs love” template.

Once your idea is submit, it will (each night) render to the interface of projects that need love, which you can see here.

Matching Yourself

When you navigate the web interface to find an issue that looks interesting, if you click the issue to navigate to the GitHub interface, you can have discussion with the author about how you might like to be involved.

What should you discuss?

The match between the starter, both project and individual, and the finisher, is very important! While the criteria might vary by project, it’s generally a good idea to open up a discussion on one of the needs-love issues and discuss the following:

  1. if expertise is known to be needed, where will it come from?
  2. how can both parties best communicate, and ask questions?
  3. what kind of time frame do you have in mind?
  4. do you have all the resources that you need?


If there is a match, great! You can match yourself simply by applying the matched label. A GitHub action will handle removing the needs-love label so that others know that you’ve taken charge. The interface will update over night.

Updating a Match

If you can no longer work on a project or idea, you should notify the starter (the person that originally submit the issue) about this change, and they can remove the matched label. Once this is done, a GitHub action will add back the needs-love label so that others know that the issue is open to be worked on.

What if someone doesn’t ask for help?

Asking for help can be hard! In some cases, asking for help can look like labeling an issue with “Good First Issue” or (more directly) “Help Wanted.” For the interested folks that want to persue a list of open source, research software engineering efforts, the rseng organization also provides the awesome-rseng awesome list. You can either contribute to these projects directly, or find one or more issues and write them up under needs-love to be discovered.

How can I contribute?

If you want to find a project to help with, you can browse the issue board or the interface here. It’s also very helpful to peruse around some of your projects, or open source projects you contribute to, and look for good “needs love” issues. Many times, you can also have discussion with colleagues to find what they are working on (and wish they had more time to work on).