DEV Community

BekahHW for Virtual Coffee

Posted on • Originally published at bekahhw.github.io on

6

Preptember: Projects and Discussions

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.

Heroku

Build apps, not infrastructure.

Dealing with servers, hardware, and infrastructure can take up your valuable time. Discover the benefits of Heroku, the PaaS of choice for developers since 2007.

Visit Site

Top comments (0)

Billboard image

The Next Generation Developer Platform

Coherence is the first Platform-as-a-Service you can control. Unlike "black-box" platforms that are opinionated about the infra you can deploy, Coherence is powered by CNC, the open-source IaC framework, which offers limitless customization.

Learn more

👋 Kindness is contagious

Please leave a ❤️ or a friendly comment on this post if you found it helpful!

Okay