Preptember: Projects and Discussions

BekahHW - Sep 20 '21 - - Dev Community

We’re still talking maintainer power ups as we move into the last half of Preptember. We’ve talked about Getting Ready for Hacktoberfest and maintainer guidelines, issues, and labels, and now we’re going to talk about some more ways to create clear paths of communication to enhance your open source project.

Since last year, we’ve seen GitHub make updates to discussions and project boards, and those are two of our favorite things. Not only do they support open source projects, but they also promote active communication between contributors and maintainers and we. are. here. for. that.

Discussions

This might not seem like a big deal, but having a step between a DM and an issue is huge for me. It’s kind of like dating. You’re not ready to make it “official” with an issue, but there’s some potential to talk through.

You can still provide discussions with labels and categories, but it doesn’t necessarily command the same consideration as an issue, which is implicitly a more “formal” relationship for consideration.

This allows for an intermediate space to discussion the potential, get feedback from other contributors and possibly maintainers.

A number of OSS projects use a chat app like slack or discord for discussing things, but that can be hard to follow, disorganized, or swallowed up by slack’s free plan or lost in fast-paced Discord discussions.

Here, maintainers can create labels that work for them, which allows for quicker time to identify, recognize, and prioritize discussions.

categories

Github discussions allow any possible contributor to watch the conversations on a public repo, understand the communication style, and to ask questions or provide feedback. You can also pin discussions that you want to highlight to potential contributors, add labels, and sort based on what you’re looking for.

discussions

Personally, I think discussions provide a safe space to hear ideas through and to think about their practicality.

Project Boards

I won’t lie here. Initially, I was very resistant to multiple repositories with different project boards. I may have even aggressively opposed them. But now, project boards are one of my favorite things. I would be lying if I said, I didn’t wish that everyone outside of tech learned on project boards as well.

Maybe it’s my ADHD, maybe it’s something else, but having tasks more clearly broken down into categories is incredibly useful for planning work, prioritizing communication and tasks, and for seeing overall progress towards and organization’s mission and vision.

And now there’s this awesome bonus where GitHub more closely resembles a Trello board.

We can assign users to tasks that make progress on an overall issue. And it’s much more readable than a repository full of issues.

projects

One of the biggest challenges here—I think—is making sure that tasks are broken down in a way that’s useful to an organization. You can always revise or reorganize, but when you put deliberate time and effort into creating a dependable situation from the beginning, you’re more likely to have support from your contributors.

When it comes down to it, our contributors are all volunteers. And when we appreciate them, make space for them, and create processes and procedures that show we value their time and effort, we all benefit.

If you have a powerup that’s been really great for your project, let us know! Either drop it in the discussion or hit us up on Twitter.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .