DEV Community

Cover image for 6 Lessons Learned Maintaining a Popular Open-Source Project

6 Lessons Learned Maintaining a Popular Open-Source Project

Simon Egersand 🎈 on June 08, 2022

Between 2016 and 2018 I maintained an open-source project with +800k downloads/month. I learned six invaluable lessons by doing this, and I will no...
Collapse
Β 
rajasegar profile image
Rajasegar Chandran β€’

We can make good commit messages common by adding the necessary tooling for the repositories like Conventional commits and enforcing the style with linters and git hooks. It will also be easy for the contributors to follow a standard convention if there is one already available for them to refer.
Anyway as a fellow maintainer, I can agree with you on these lessons.

Collapse
Β 
simeg profile image
Simon Egersand 🎈 β€’

In my experience, tooling can only do so much to help with good commit messages. I believe more in a good mindset. If you know the value of a good commit message you will write a good commit message. But if you don't know the value it might just be an inconvenience.

Collapse
Β 
user64bit profile image
Arth β€’

Wow, that was great πŸ‘
I was thinking about maintaining open-source project,

Thanks for sharing your experience

Collapse
Β 
simeg profile image
Simon Egersand 🎈 β€’

I'm happy you liked it! :)

Collapse
Β 
shinigami92 profile image
Shinigami β€’

Happy to read your experience
I'm one of the maintainers of FakerJS and I can definitely agree with most of your experiences

Collapse
Β 
simeg profile image
Simon Egersand 🎈 β€’

That's, in a way, comforting. I'm not alone πŸ˜‹

Collapse
Β 
gulshanaggarwal profile image
Gulshan Aggarwal β€’

Amazing content!

Collapse
Β 
simeg profile image
Simon Egersand 🎈 β€’

Thanks, Gulshan! I'm glad you liked it :)

Collapse
Β 
drwrongmo profile image
Jon Wright β€’

I'd love to see a follow up post of what you think a good commit message entails.

The must haves. Things to consider including. Things to exclude.

Collapse
Β 
simeg profile image
Simon Egersand 🎈 β€’

I love discussing what makes a good git commit message. That's a great idea! I've added it to my list of topics.

Collapse
Β 
aquadrehz profile image
AquaDrehz β€’

I saw python lib named diagrams.
It used to create diagram picture from code. It got a hundreads of PR remained. Still thinking to hop on. But python is not my prefered language. Any suggestion?

Collapse
Β 
simeg profile image
Simon Egersand 🎈 β€’

My advice is to try it! You will learn something, even if Python is not your preferred language. Consider it a challenge and I think you'll enjoy it :)

Collapse
Β 
lorenzojkrl profile image
Lorenzo Zarantonello β€’

Nice one!
Good food for thought!
I think everyone could be a bit more aware of that little Git Commit we write multiple times per day!

Collapse
Β 
stvbyr profile image
Steve β€’

Nice read! Regarding the documentation part I’m quiet on the opposite. I am happy to read documentation because than I don’t have to ask questions. πŸ˜„

Collapse
Β 
simeg profile image
Simon Egersand 🎈 β€’

OSS maintainers love people like you πŸ˜„

Collapse
Β 
areful profile image
Areful Islam🀝🌎 β€’

Keypoints are great. Is that all open-sources are same scenario?

Collapse
Β 
simeg profile image
Simon Egersand 🎈 β€’

This is my experience. I don't know how it is for other projects. But I would guess many maintainers can relate.

Collapse
Β 
andrewbaisden profile image
Andrew Baisden β€’

Super insightful not everybody has a first hand experience working on open source projects. Great article.

Collapse
Β 
simeg profile image
Simon Egersand 🎈 β€’

Thanks, Andrew! I learned a lot and I would recommend this to anyone who's up for a challenge :)

Collapse
Β 
laianbraum profile image
Laian Braum β€’

Such a short and great read! Thanks for this article, Simon! You gave me some really interesting points to think about.

Collapse
Β 
simeg profile image
Simon Egersand 🎈 β€’

Thanks! I'm glad you liked it.

Collapse
Β 
glenn_miller_860ba12ffbf7 profile image
Glenn A Miller β€’

"Stuff We All Get"

Thanks for that!

I always wondered what that stood for.