+1<br><br><div class="gmail_quote">On Fri, Mar 15, 2013 at 12:26 PM, Douglas Campos <span dir="ltr"><<a href="mailto:qmx@qmx.me" target="_blank">qmx@qmx.me</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Thoughts?<br>
<br>
-- cut here --<br>
# AeroGear Versioning Policy<br>
<br>
For this 1.0.0 release and beyond we're planning some significant changes on how we do versioning for the project.<br>
<br>
## TL;DR<br>
<br>
We're sticking to the de-facto standard of `major`.`minor`.`patchlevel`, mostly know as Semantic Versioning, or just [semver].<br>
<br>
## A bit of history<br>
<br>
During the early days of the project, we started following the [JBoss Project Versioning] - at that time our assets were mostly Java. Then we found out later that we were doing it wrong, because we forgot the timestamp part of the milestone releases.<br>
<br>
## Getting it right<br>
<br>
So we're going to release 1.0.0 in a few days, and we'll drop the suffixes and work with versions like this:<br>
<br>
- **bugfixes**:<br>
- increment `patch` (1.0.0 -> 1.0.1)<br>
<br>
Bugfixes and minor changes: keeps API compatibility<br>
- **new features and small breaking changes**:<br>
- increment `minor` (1.0.1 -> 1.1.0)<br>
<br>
**Small breaking changes** means that some work **may** be needed for updating beetween minor versions.<br>
- **major releases**:<br>
- increment `major` (1.1.0 -> 2.0.0)<br>
<br>
Mostly backward incompatible changes and/or when a group of big features is ready.<br>
<br>
Any release can use the discriminators .alpha/.beta/.pre for testing, those are sorted right.<br>
<br>
<br>
[semver]:<a href="http://semver.org" target="_blank">http://semver.org</a><br>
[JBoss Project Versioning]:<a href="https://community.jboss.org/wiki/JBossProjectVersioning" target="_blank">https://community.jboss.org/wiki/JBossProjectVersioning</a><br>
<br>
-- qmx<br>
<br>
<br>
_______________________________________________<br>
aerogear-dev mailing list<br>
<a href="mailto:aerogear-dev@lists.jboss.org">aerogear-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
</blockquote></div><br>