allejo

A developer pretending to know what he's doing • https://allejo.io

Show Your OS Devs Some Love

I've been lurking around the open source community for about a decade now. I say lurking because I feel like I lurk more than I actually contribute. Though, judging by the little squares on my GitHub profile, I am by definition: fairly active. My favorite time of the year is Hacktoberfest because I do my best to find a community I don't typically hang around and see if I can contribute. Sure, I could always go to those "we'll accept any PR during Hacktoberfest" repositories, but where's the fun in that?

In the past, I really enjoyed making random apperances in the Docker Docs repository in unexpected ways.

So if you're browsing the Docker Docs site and enjoy how smoothly the sidebars work with scrolling, how that hamburger actually appears at a reasonable breakpoint, or if you're maintaining the source and you like how the navigation for the entire site is now in a single include... You're welcome.

I loved the Docker Docs team at the time. I wasn't in any way affiliated with Docker, but they'd reach out to me from time to time with questions. I loved it. I was in college, so I needed something to keep me busy during my mundane classes and they gave me just that. Heck, they even sent me some free swag; thanks Misty!

As with anything in life, things change. My favorite docs team members left to other companies; good for them! I figured I'd continue to make apperances regardless so back in April 2018, I submitted a PR to take down the GitHub pages hosted version of the site; something they'd been asking for help with. At the time of writing this, the PR remains open and mostly untouched.

For Hacktoberfest, I looked through the PRs to see if the one I had created in April had finally been merged or closed. Maybe I missed the notification? Nope. Untouched since April. A few days later, it was bumped on the 4th. I thought to myself, "Ok, I guess taking down the GH version of the site might take some long internal discussion." I work for the government, I'm used to slowness in decision making. In the spirit of Hacktoberfest, I decided I'd try fixing some site bugs. I submitted PR #7496, which would fix the browser history spam you'd get as you scrolled through any page. Fast forward 2 months. Untouched. No comments. No labels. No assignments.

<sarcasm>Man, I'm really feeling the love from the Docker Docs team...</sarcasm>

Since I make it a personal goal to contribute to new communities during Hacktoberfest, I found Kong Inc. who was looking for a way to automate creation of Table of Contents on their GitHub pages hosted site. Doesn't that sound familiar to another community I once helped out? I submitted PR #920 and I had such an enjoyable experience in doing so! Working with @coopr was so productive! I had questions on how they wanted something implemented, they had answers and feedback quickly! It took about 13 days to iron out this PR and get things "just right" but it was well worth it. Not only did Kong get a new feature on their documentation site, it was discovered that there were many improvements and updates needed throughout. These were tackled by other members of the community in the coming days. Now that's what I call collaboration.

A few days later after my PR was merged, I get pinged on Twitter by the Kong account thanking me for adding the auto-TOC feature to their site. Then much much later, I get pinged once again telling me about how they mentioned me in their blog post. Kong gave me more attention than my parents ever did; it's such a nice feeling to be loved.

So what's the moral of this story?

  • Thank your open source contributors! A simple "thank you" when your merge their PR goes a long way. Tag them in release notes. Give them credit!
  • Be responsive and kind to PRs. Remember, people are taking time out of their day to contribute to your project. So be responsive and give them feedback. A PR will likely not be mergeable on the first try, so give them feedback on what to do to make it mergeable. There's nothing more satisfying to me than getting feedback from a team of a project I care enough about to contribute to.

It's really that simple. In this story, Kong Inc. went above and beyond with showing me so much love in everything they mentioned me in and I appreciate all of that! I'm really feeling the love from Kong. There's not a doubt in my mind that I'd return to the Kong community far quicker and more willingly than I would the Docker one.

Rants