releasing modules using semantic versioning

(Bringing a comment from another thread back here.)

Executive Summary

When you release a module, the next version should be a minor version increment, both in Maven and JIRA.

Details

The default assumption should be that the next release will be a minor release, not a maintenance release. If someone wants to do a bugfix-only release, they can create an extra fixVersion at the time. Thinking historically, we have almost never done maintenance releases of modules.

E.g. when you’re releasing REST 2.18.0, the next version should be 2.19.0, so (1) you’d only create a JIRA version for 2.19.0, and (2) you’d set the working version to 2.19.0-SNAPSHOT in maven.

The maven release plugin does not do this by default (e.g. when you release 2.18.0 it defaults to 2.18.1-SNAPSHOT), but maybe we can get around it with this flag (I haven’t checked how), or in our bamboo release plans.