Category: Posts

General content posts. You know: the stuff you’re here to read!

Bug fixes only matter if they get to the user

Any bug that blocks a release from getting to users is worthy of an immediate fix release. This is true even if the bug is minor by itself.

Posts

Should you care about GitHub stars?

When I read Emily Omier’s post “I don’t care about your GitHub stars“, my first response was total agreement. Dopamine doesn’t show up on the balance sheet, after all. Of course, Emily is looking at it through a lens of building a company. It’s a perfectly valid perspective, but it’s not the only one. In (I think) a LinkedIn comment,...

Posts

Conway’s Law applies to your documentation, too

In order to keep your documentation from falling into the Conway trap, you have to actively curate it across the entire project.

Posts

Incentives power open source

A company making requests of a project has to explain the incentives in a way the project members will care, not in a way the company cares.

Posts

Grow by delegating

Don’t hoard responsibility. Give new contributors a sense of ownership so that they’ll stick around your community.

Posts

Semantic versioning in large projects

SemVer can work for large projects, but it’s not a fit for every case. Whatever you pick, document it clearly.

Posts

Keep your bug tracker unified

When your bug tracking is scattered across different platforms, you make it harder for your users to file reports.

Posts

Fork yes: embrace forks of your project

If you’ve done what you can to make your community a great place to contribute, then you can feel free to embrace any forks that happen.

Posts

Companies: fund work that isn’t new development

Failing to invest in your upstream projects presents a large business risk. Communities, like gardens, are more productive when tended to.

Posts

Don’t try to be too formal in policy writing

Don’t emulate legal language when writing policies for your community. The simpler the language, the easier everyone will understand.

Posts