Subscribe to my newsletter if you enjoyed this article.
GitHub published a curious article on avoiding burnout for open source maintainers. It’s an important topic that should be discussed more widely, and I appreciate that GitHub published it.
The article has a good overview of possible burnout reasons, and gives some suggestions on how to avoid it. However, I feel that the main goal of the article is to convince maintainers to keep doing what they are doing for as long as possible, meaning to keep working for free. The article briefly mentions sponsoring but for most maintainers it’s unrealistic to rely on sponsoring or donations.
I think the most healthy solution for avoiding maintainer burnout is quitting open source entirely, at least it was a solution that worked for me. Unfortunately, I had to reach the state of burnout myself to understand that, and then it took me long time to recover (or replace maintainer burnout with a burnout in other areas of my life).
I’ve talked before on why open source was attractive to me, and a bit on why I was contributing less, and eventually quit open source.
In this article I want to talk more about the reasons that led me to maintainer burnout, and to quitting open source after about ten years of contributing regularly, and publishing many projects.
So what are the reasons?
Entitlement and toxicity of users
Somehow people expect you to solve their issues or implement features they need. They’ll complain that the bug you introduced in the last version broke their build, or that they need this obscure feature for their current project at work, and that if you don’t add it quickly, their boss will go berserk because the deadline is already on the nose.
Folks seem to miss that you’re working on these projects in your free time, after a long day at your full-time job, and without any compensation. They demand that you work on whatever is, in their opinion, broken or missing, and then they get angry when you’re not doing it or not doing it fast enough.
They miss that you might be the only person working on the project, that you’re not a part of a large team that’s paid to work full-time on maintaining the project and solving issues of its users.
Somehow, open source became a synonym of free labor, not just free code, and it’s harmful for the whole community but mostly it’s harmful for maintainers of open source projects.
And then, there are all the toxic comments (see just a few examples) that tell you that your software is garbage and you should just kill yourself quit programming, all the plus-ones (“I have the same issue”), all the pings (“any update on this?”), and other spam comments that don’t add any value…
Low quality of contributions
I often felt like managing contributions takes more time than implementing the same features myself.
The overall code quality of pull request to open source projects is usually very low, and each pull request requires a lot of time and mental effort to review, requires many comments and many iterations to bring it to somewhat an acceptable quality.
It often takes several months to merge a single pull request, many get abandoned, or their authors get frustrated and angry. Often someone submits a pull request, and never comes back to it again, so you waste time and energy reviewing their code for nothing (I call such pull requests hit and run pull requests).
People often submit features they want but it doesn’t always match the project’s vision or is outside of its intended scope. They also believe that accepting their work is free for you, not thinking that you first need to review the pull request (likely multiple times), and then maintain the feature once it’s merged (likely forever).
And the darkest time for an open source maintainer is October, when during the Hacktoberfest people around the world spam maintainers with total nonsense just to get a free t-shirt.
Lack of community
Most of my projects never got popular despite all my efforts to make them useful and to market them. If nobody is using your project, why bother fixing bugs, writing documentation, making a nice site, and so on?
My last project, Squirrelsong color theme is a good example here. I’ve invested a lot of time on making this theme, and I think it’s better and different enough than many existing themes, and yet, it seems that I’m the only user.
My most popular open source project, React Styleguidist, has over 10K stars on GitHub, and yet, I couldn’t manage to build a community around it, and to make it self-sufficient. The project is too big for one person to build it, and to manage issues and pull requests.
I had some good contributions over the years on various projects, but most of the time they require a lot of collaboration from my side. A few people were interested in maintaining some of my projects but, again, they needed a lot of guidance from my side, so it never felt like it’s saving me any time and effort.
There should be enough people actively working on a project to respond to issues, review pull requests, and work on new features, so even if some of them get hit by a bus can’t work on a project right now, it’ll continue. In reality, however, if I wasn’t doing everything, the projects would stop completely, and the issues would start to pile up.
Lack of compensation
Maintaining an open source project is a hard and demanding job, as any other job. The difference is that we usually get paid to do other jobs but not for open source. Few developers could make a living (or at least any significant money) doing open source, for the majority of us it’s nothing but frustration.
The most money I got for my open source work was for React Styleguidist via Open Collective. And it was barely enough to buy a pack of stickers once in a while. The current monthly budget of the project is $8.
I’ve tried GitHub sponsors, with zero results, apart from one-time $550 contribution from GitHub itself that was mysteriously cancelled the same day.
I have a Buy me a coffee button on every project’s readme but I don’t think I ever got a single cup from there. (I got some coffees from Unsplash though, which is also nothing for over 1,5 million downloads of my photos there.)
Lack of tooling
There are two problems with tooling that open source maintainers have to deal with.
First, the complexity of tooling involved in development of a typical open source project:
- Publishing JavaScript code (can’t speak about other languages — most of my work is JavaScript and TypeScript) in a way that it could be used by many people is very complex, and it’s getting worse.
- Dependency upgrades often take ages, and if you have multiple projects, it could turn into a year-long adventure (I even made a tool to help with that).
- Generally, the amount of configuration (TypeScript, linters, bundlers, releases, dependencies, testing, continues integration, changelog generation, and more, and more, and more…) is quickly getting out of hand.
Second, GitHub could do so much more (more than nothing) to protect its users from toxic people. For example, GitHub could:
- Detect toxic comments, and either remove them automatically, or mark them for manual review.
- Remove spam comments, and convert plus-ones to thumbs up reactions.
- Educate users posting such comments by teaching them better behaviors, or banning them if they don’t want to change.
- Make project status clear: make it clear whether a project is backed by a company or maintained by someone in their free time.
I had to ignore any activity on many projects on GitHub just to avoid people at-mentioning me all the time.
Conclusion
Something has to change to make open source healthy but for now I don’t want to be part of it. I don’t want to help corporations make millions on free code, and receive rude comments instead of any kind of recognition.
The worst part is that it’s getting worse, not better.
Now I consider my open source projects as personal projects whose code happened to be open. It’s convenient to keep code on GitHub and use npm to share code among several projects. I only add features that I need myself, and when I need them. I don’t receive notifications on any activity on these projects. I rarely look at the issues or pull requests, and I almost never respond to them.
Perhaps, I should either disable the issues entirely, or add a note explaining that they will likely be ignored and they may be more successful by forking the code. I guess, I still want projects to have a place for users to report bugs so that other users could suggest workarounds.
I’ve written about possible solution to these issues.
Subscribe to my newsletter if you enjoyed this article.
Oldest comments (43)
I wholeheartedly agree with your perspective on contribution quality. And for that reason when I spot a bug in open source project I always create issue instead of pull request. I know many iterations it takes to get pull request aligned with coding standard, coding naming, test flow, documentation style and other aspects specific to a project. Even experienced developer make not make it right on the first try. Call me lazy, but I think project maintainer will have less mental load when fixing bug himself based on well described issue than reviewing someone's code few times.
You also mentioned few things that everyone considering starting open source project should be aware of:
I think those should be mandatory check boxes when you click to create new repository on GitHub :P
Ah, and I forgot to mention that open source never helped me to find a better job...
That is interesting. Isn't the generally spread notion that contributing to open source is the ticket to either finding a job or a better one?
I don't think I have ever actually contributed to open source because I don't understand it very much, and I do not believe myself to be that knowledgeable. I always thought it(my lack of contribution) was my reason for not getting a "better job".
It is a very widespread myths about open source, which in reality isn’t the case for most people. So don’t bother if that was your motivation ;-)
It might be useful for learning a few new things though…
You're definitely right about the learning, and at this point; that's what I'm going for.
Thank you though for the article. Provided a lot of insight.
So sorry you had to go through this 🚀
🤗
Really insightful. I sometimes feel it's a personal failing when I don't contribute to my open source projects, or that I'm a lesser engineer, but now I realise that I've been manipulated by the expectations of open source.
I will continue to build and learn as my business requires, and spend my free time with my hobbies :)
Yeah, the guilt of not contributing is a thing that shouldn't be there. I'm glad you're recognizing it ;-)
I disagree with the author’s viewpoint on quitting open source.
Open source projects can be a great way to build a portfolio and gain valuable experience in software development, which can be beneficial when pursuing a career in computer engineering or starting a business.
and can lead to recognition and even potential job opportunities. Many companies value open source experience and actively seek individuals who have contributed to such projects.
This is one of the biggest myths that open source is somehow magically helps to find a better job. And to build a portfolio (and I already have one) I don’t need to accept pull requests, look at the issues, or be a target of entitlement and toxicity.
While I don't entirely agree with the author, he's got a point. Some great Open Source projects are truly dev-friendly, helpful, and helping you to learn. And I think I was lucky to be a part of such.
But there are also a lot of toxic projects, developers, and communities. Some examples were mentioned in the article. We also saw what happened when Turbo dropped TypeScript support.
That said - I hope you will give Open Source another chance, and I hope you'll be lucky this time. But I understand why you did what you did - we only have one life and there are better things to do than to argue over the internet with strangers over few lines of code.
I gave open source way too many chances already — it’s been about 10 years, and the effect on my mental health is too bad to try again. However, I’m not making my code private overnight, I’m just quitting the social part of it.
Sorry to hear you go.
I think that a more filters are better for OSS, so you can get more reliable and better quality contributions.
I think that forming a team of contributors is much more efficient than getting lots of random requests and pieces of code from random people.
Treating it like a job that you work on whenever you want to, full with project management, having devs with experience and knowledge you know you can rely on, communication tools, having meetings, etc. Is the best way to work in projects, just like at regular dev jobs.
You can also plan a sustainable financial model so you can keep your work free, e.g funds for OSS for developing things in a specific area, or ads.
Well, as soon as I'm being paid for it like for a job, I'll treat it like a job. But until then...
After going through your article, I was bound to share my opinion as well. This time, through a video.
Well written. I've always had an inkling about that. For me, it was because everyone started doing it. Everybody is trying to build his/her own project and get popular, so obviously many people will not make it. There's no way it can fulfil the promise for the millions pouring into it.
Then as you said, corporations making money off of free work is definitely a huge part of it. 😂
It's however, not a bad idea for building portfolio.
That's precisely my point: to build a portfolio you don't have to deal with the social part of open source ;-)
I have a project that has just a bit more than 100 stars and I already have this problem so I can't imagine what projects with thousands of stars have to go through. This must be painful, unfortunately.
In my case, I took some actions to get a bit less stressful, like:
Other things that can help are:
That's it.
Or you can just quit and that is totally fine! And if you are really mad, just archive the repo or make it private for a while.
Peace!
Hi! I like very much the actions you took. I find the point 2 useful and straightforward. Thank you
I've gone through all of these steps and it's not enough for me. It still takes a lot of time without any significant benefit for me.
I don't care too but I also don't want to see them, I don't want to waste my time reading them, hiding them, and then banning the author.
In this case, the best solution for your mental health is quitting, which is totally fine and understandable.
@sapegin : Great write up. This is a dark side of Open Source. I still believe things might be going down the wrong path, but we being part and identifying and redirecting things might help improve the situation.
I hope you still continue making quality contributions to open source and don't completely give up on it.
I'm giving up the social part of it, not taking down all my projects or making code private ☄️
Some comments have been hidden by the post's author - find out more