Hacktoberfest 2023: First Experience as a Maintainer

Ayu Adiati - Oct 20 '23 - - Dev Community

Hi friends! πŸ‘‹

I'm Ayu, a tech blogger, front-end developer, and open source and tech community enthusiast based in the Netherlands.

I'm participating in Hacktoberfest for the 5th time this year. In my pledge post, I mentioned that this year, I want to focus more on supporting the open-source community, especially beginners in open-source.

I never imagined that I could go this far. But this year marks the first time I become a maintainer for projects in several tech communities. Not only did I get the opportunity to maintain projects and to learn more about open source, but my wish to support beginners in open source also came true! πŸ₯°

grateful GIF

How the Journey Began

My open source projects maintainer journey began with the Preptember 2023 challenge at the Virtual Coffee community. After a discussion with the Monthly Challenge Team, we proposed to the Core Team to create and maintain a repository for our members to practice open source and list repositories that we can verify for Hacktoberfest 2023.

It was the first time ever I prepared a repository to be ready for contribution as an open source project from scratch! 🀩

And it was a success! πŸ₯³
I'm happy to see the enthusiasm of our members contributing to this repository.

GitHub logo Virtual-Coffee / vc-preptember

A repo for Virtual Coffee members to practice open source and to list VC-verified repositories.

Welcome Preptember!

This is a special repository for Virtual Coffee members to prepare themselves for Hacktoberfest by practicing open source and listing VC-verified repositories we can recommend for Hacktoberfest.


πŸ“’ Only PRs from existing Virtual Coffee members will be accepted.


You can watch our video walkthrough to learn more about this repository and how to contribute:

VC.Preptember.Repo.Walkthrough.mp4

🀝 Contributing

See our contributing guide for detailed information and instructions on contributing to this repository.

πŸ’­ Do you have questions?

Whenever you need help, you can ask for it in the #open-source or #help-and-pairing channels in Slack. You can also read our guide on how to ask questions.

We're here to help you! πŸ’™

β˜• Join Virtual Coffee Community

If you're interested in joining our community, you can learn about us through our website and join the waitlist.

βš–οΈ License

MIT Β© 2023 Virtual Coffee




Opportunities to Maintain More Projects

Towards Hacktoberfest, I had more opportunities to maintain projects in several tech communities, especially during the event.

OpenSauced

OpenSauced is a platform to help engineers to expand their resume through open source contributions.

I have been contributing to OpenSauced projects, from raising issues around the app to improving documentation in some repositories. These processes make me familiar with those repositories and give me a sense of how to improve things around the projects.

I didn't think twice to say yes when OpenSauced offered to support them in maintaining some repositories. And it was an honor when they announced that I'm officially part of the Community Maintainers Team, together with @bekahhw and @cbid2.

New Maintainers Announcement at OpenSauced

Here are the projects that I help to maintain:

Intro to Open Source with OpenSauced

This repo contains a course designed to introduce beginners to open source and guide them through contributing to open source projects.

GitHub logo open-sauced / intro

Empowering Your Open Source Journey: From First Contribution to Project Leadership

Β 
Β  OpenSauced Β 

πŸ• The Open Source Education Path with OpenSauced πŸ•

Β  Welcome to OpenSauced's Intro Repository!

This repository is the home of OpenSauced courses for people who want to learn to contribute to open source projects and for people who want to become project maintainers.

Head over to the Intro to Open Source Course or Becoming A Maintainer Course on GitHub to start learning! Alternatively, visit our Open Source Education Path with OpenSauced website.

Check out the Community Translations for translations maintained by our community!

🀝 Contributing

We encourage you to contribute to OpenSauced! All contributors are required to abide by our Code of Conduct.

πŸ• Community

Do you have questions or need help? Join our Community…

The OpenSauced Guestbook

While folks are taking the Intro to Open Source with OpenSauced, they will put their skills into practice in one section by contributing to this guestbook repo.

GitHub logo open-sauced / guestbook

The place where future contributors are born


OpenSauced

πŸ• Guestbook πŸ•

Welcome to OpenSauced's Guestbook Repository!

OpenSauced Guestbook

This guestbook is a place for people who have taken OpenSauced's Intro to Open Source course to take their first steps into contributing to open source.

Getting Started

For complete instructions on how to add yourself to our guestbook, please head to the "Let's Get Practical" section in our Intro to Open Source course.

Resolving Merge Conflicts

If you encounter merge conflicts while contributing to this repository, read our Intro to Open Source course's "Merge Conflicts in the Guestbook Repository" section.

What's Next?

You can add this contribution to your Highlight at OpenSauced! Read our docs to learn more about Highlight feature.

Hungry for more contributions? Check out our pizza-verse repository and join us in celebrating pizza!πŸ•

🀝 Contributing

All contributors are required to abide by our Code of Conduct. Please follow our…

Pizza Lovers Repository

After finishing the intro course and contributing to the guestbook repo, folks can expand their open source journey by contributing to our pizza-verse, the repository for Pizza lovers!

GitHub logo open-sauced / pizza-verse

A repository for all things pizza.


Open Sauced

πŸ• Pizza Lovers Repository πŸ•

Welcome to OpenSauced's Pizza Lovers Repository!

Pizza Lovers Repository

Introduction

The Pizza Lovers Repository is a collaborative project where we can come together and contribute pizza-related content. Whether you have a fantastic pizza recipe, an interesting pizza fact, or just want to share your opinions on the best pizza toppings, this repository is the perfect place to do it!

You can now add a traditional food from your hometown or country to this repository, in addition to pizza!

Repository Structure

Share your favorite pizza recipes. Whether it's a classic Margherita pizza or a unique creation of your own, this category aims to provide a variety of pizza recipes for everyone to enjoy. Contributors can share their recipes, including ingredients, cooking instructions, and other relevant details. Feel free to include images of your pizza creations to inspire others to try your recipes!

SheSharp

SheSharp is a non-profit foundation based in the Netherlands that makes it easier for all women and non-binary people to enter, stay, and grow in the tech industry.

My open source journey with SheSharp began with offering my help to support the community during Hacktoberfest through answering questions about open source, supporting beginners, and/or reviewing issues and PRs.

After raising an issue to improve their documentation, I collaborated intensively with the maintainers to improve the documentation and repositories to prepare them for Hacktoberfest contributions. I also actively gave ideas around open source and Hacktoberfest for our community. From there, I am trusted to be one of the maintainers for their open source projects.

One of the projects that I help maintain:

Knowledge Hub

This repository contains a collection of resources covering different areas, from tech-related, such as software development, data analysis, product management, and quality assurance, to the general ones that can help others, such as housing in The Netherlands, supportive tech organizations, etc.

GitHub logo shesharpnl / knowledge-hub

The knowledge hub provides useful resources for SheSharp community members.

SheSharp Knowledge Hub

This is a collection of resources gathered by SheSharp community.

It includes a table of contents for you to navigate to the sections that matter the most to you.

The resources collected here cover different areas, from tech-related, such as software development, data analysis, product management, and quality assurance, to the general ones that can help others, such as housing in The Netherlands, and so on.

Table of Contents

Contributing

Before starting, please read our Contributing Guide for detailed information and instructions on contributing to this repository.

Socials

Resources

Careers

Support

If you encounter any issues, have questions, or need assistance, please refer to our support documentation.

Code of Conduct

To ensure a welcoming and inclusive community, we have established a Code of Conduct that applies…

Virtual Coffee

Virtual Coffee is, and always will be, a genuine tech community that values and prioritizes supporting one another.

As Documentation Team Lead at Virtual Coffee Community, I regularly contribute to our repos to maintain documentation. However, this year is my first time co-maintain one of our repositories.

The repository that I help to maintain:

Podcast Transcript

This repository contains the transcripts for the Virtual Coffee Podcast.

We aim to make our podcast transcripts more accessible and enjoyable to read by all audiences. At the moment, the transcripts are automatically generated, and they contain some mistakes. We need to edit the transcripts manually by listening to the episode and improving it.

GitHub logo Virtual-Coffee / podcast-transcripts

SRT files for podcast episodes

Podcast Transcripts

Transcripts for the Virtual Coffee Podcast.

Contributing

See our Contributing Guide to get started on contributing to this repository.

Transcription Guidelines

Check out the Transcriptions Guidelines for transcribing details!

Downloading Episodes

To download the latest episodes, run the following command:

yarn download
Enter fullscreen mode Exit fullscreen mode

Fixing Formatting Issues

The transcripts are saved in the SRT format. This repo contains a tool to help.

yarn check-srt
Enter fullscreen mode Exit fullscreen mode

This tool will:

  • Check for invalid timestamp formatting
  • Find and attempt to fix indexing issues

After running yarn check-srt, fix the incorrect timestamp(s) format manually, if any.




The Highs

One of my biggest accomplishments as a maintainer is learning to give feedback and communicate better with contributors.

For example, I walked a new contributor through resolving merge conflicts. I provided the steps as well as some necessary screenshots for better understanding in this PR.

By observing incoming contributions, I now have better eyes to see our contributors' pain points and how to ease maintainers' tasks.

For example, most contributors who contribute to the guestbook repo are beginners, and this repo has a high risk of getting merge conflicts. Facing merge conflicts is very scary and intimidating, not only for beginners but also for folks who already have experience in contributing.

So, I created an issue in OpenSauced's guestbook repo to add a section for resolving conflicts and working on the documentation update. Adding this section would help contributors resolve the conflicts and help maintainers from having to walk through the process of resolving conflicts for each contributor.

Another thing is I created my first-ever video walkthrough to resolve conflicts in Virtual Coffee's Preptember repo.

The Lows

As a contributor, I understand the risk of getting a PR not accepted whenever we don't ask to be assigned to an issue unless the contributing guidelines state otherwise.

But now, as a maintainer, I had my first experience closing a PR that didn't follow the rules. Our guidelines clearly state that contributors must ask to be assigned to an issue before they can work on changes. However, a contributor submitted their PR without asking us to be assigned. That was heartbreaking, but rules are rules.

Growth

growth GIF

My communication and mentoring skills have greatly improved since becoming a maintainer. I have also become much better at putting myself in other people's shoes and seeing things from their perspective.

I used to be disappointed in myself if I couldn't contribute to a project because someone beat me to it (and this happened a lot! πŸ˜‚) or the issues were interesting but too difficult for my expertise. Raising an issue or getting PRs merged gives us the feeling that we do contribute because we can show them, right?

But now, as a maintainer where most of my tasks are reviewing issues and incoming PRs, I have learned that giving feedback and ideas is very valuable in open source. We cannot showcase feedback and ideas, so it may not get enough recognition. But it helps people who need them most. What is more rewarding than helping others to learn and grow?

So far, the hardest part for me is learning to say no and reject PRs when they do not follow the rules. But, hey, it's part of the growing process! πŸ˜„

Seeing contributors take or discuss feedback, learning something new, and getting their PRs merged gives me happiness. Discussing ideas and supporting other maintainers gives me joy.

I'm so much in my happy place right now because not only do I support them, but they also help me in learning and becoming a better maintainer (and contributor). πŸ’™

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