Be Nice and Write Stable Code
I&#x27;m maintaining an open source project[0] and I&#x27;m struggling with using SemVer because my &quot;app&quot; doesn&#x27;t have a single API but a few:<p>At it&#x27;s core it&#x27;s a node app. Though I also include a small web server that wraps around it (and a UI frontend).<p>1. It allows people to write scripts (js) that receives inputs and passes on events based on an API (the strategy API)[1].<p>2. It has extensive configuration[2] that sometimes changes form (the config API).<p>3. It talks to a number of external services (crypto exchanges), over a &quot;common&quot; protocol called the &quot;exchange wrapper API&quot;[3] (I am ignoring the version of the exchange API being consumed).<p>4. The wrapped webserver comes with an API (REST + WS)[4].<p>5. The &quot;core app&quot; is a chain of plugins, when they change the required config&#x2F;events also change (usually breaking changes 1 and 4)[5].<p>I could take all of these components apart (microservice way) and version them separately, but I like the monorepo style I use now where pulling one repo means that everything is working together. Also the fact that (in bug reports) people only have to refer to one version (and when on nightly maybe the git commit if I need more details).<p>But versioning is a mess.<p>[0]: <a href="https:&#x2F;&#x2F;gekko.wizb.it&#x2F;" rel="nofollow">https:&#x2F;&#x2F;gekko.wizb.it&#x2F;</a><p>[1]: <a href="https:&#x2F;&#x2F;gekko.wizb.it&#x2F;docs&#x2F;strategies&#x2F;creating_a_strategy.html" rel="nofollow">https:&#x2F;&#x2F;gekko.wizb.it&#x2F;docs&#x2F;strategies&#x2F;creating_a_strategy.ht...</a><p>[2]: <a href="https:&#x2F;&#x2F;github.com&#x2F;askmike&#x2F;gekko&#x2F;blob&#x2F;develop&#x2F;sample-config.js" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;askmike&#x2F;gekko&#x2F;blob&#x2F;develop&#x2F;sample-config....</a><p>[3]: <a href="https:&#x2F;&#x2F;gekko.wizb.it&#x2F;docs&#x2F;extending&#x2F;add_an_exchange.html#Gekko-39-s-expectations" rel="nofollow">https:&#x2F;&#x2F;gekko.wizb.it&#x2F;docs&#x2F;extending&#x2F;add_an_exchange.html#Ge...</a><p>[4]: <a href="https:&#x2F;&#x2F;gekko.wizb.it&#x2F;docs&#x2F;internals&#x2F;server_api.html#REST-API" rel="nofollow">https:&#x2F;&#x2F;gekko.wizb.it&#x2F;docs&#x2F;internals&#x2F;server_api.html#REST-AP...</a><p>[5]: <a href="https:&#x2F;&#x2F;gekko.wizb.it&#x2F;docs&#x2F;internals&#x2F;events.html#List-of-events-emitted-by-standard-plugins" rel="nofollow">https:&#x2F;&#x2F;gekko.wizb.it&#x2F;docs&#x2F;internals&#x2F;events.html#List-of-eve...</a><p>-------<p>This is not a criticism, I typed this out in the hope that someone can point me in a sane direction (given the discussion on versioning)