Open source wizards: What's your protocol to prepare for breaking changes?

• semver

  721 7,026 0.6

  Semantic Versioning Specification

  

Have a read of https://semver.org/ about semantic version ing for ins, outs, and why's.

• erdtree

  57 2,247 7.3 Rust

  A modern, cross-platform, multi-threaded, and general purpose filesystem and disk-usage utility that is aware of .gitignore and hidden file rules.

I recently had one of my pet projects (a CLI) that I'm actively developing during my free-time receive a decent amount of traction on Github. This is the first time any of my projects has gotten this sort of attention so I'm learning the ways on how to be a responsible open-source author and maintainer. With that said my project is currently stable and healthy at version 1.8.1 so now, with the benefit of hindsight, I want to make pretty significant changes and correct some bad decisions that I pigeon-holed myself into earlier in its development, however, I'm not really sure on how to go about it with regards to how best to communicate these changes to everyone.

• WorkOS

  workos.com featured

  The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.

  

Suggest a related project