Your changes sound much clearer to me.
Adrian Crum
Sandglass Software
www.sandglass-software.com
On 8/7/2014 3:16 PM, Ron Wheeler wrote:
On 07/08/2014 9:08 AM, Jacopo Cappellato wrote:
On Aug 7, 2014, at 2:26 PM, Ron Wheeler
<[email protected]> wrote:
That is not what the doc says. It says that 13.01 should be the first
release of the 13 series.
No, this is not what the doc says, please read carefully.
"<Minor Release Number> is a two digit sequential number: 01 (if
specified) is the first release from the branch; 02 is the second
etc...; for a given Major Release Number you should always use the
release with the highest Minor Release Number because it represents
the latest bug fix release for the Major Release Number you are using."
Exactly,
and the first minor release number is always 01, then 02, then 03 and
so on.
The only part where you are wrong is the major release number that is
"13.07" and not, as you assume, "13". As explained in the docs our
major release number is in the format: YY.MM
Frankly speaking I don't like the format of the major release number
(as I mentioned a few times) but it is what it is and changing it now
may add further confusion.
I get it now.
That is a very non-standard way to version things.
Here are a couple of suggestions about how to fix the docs to make this
clearer to someone used to "normal" 3 part versioning.
Possible change:
"The naming convention for OFBiz releases is <Major Release
Number>.<Minor Release Number> where:"
could be changed to:
"The naming convention for OFBiz releases is <Major Release
Number>.<Minor Release Number> for example <13.07>.<04> where:"
This would at least alert the reader to the fact that something unusual
is coming and needs to be read carefully.
"a new Major Release Number is normally created every year in April
(09.04, 10.04, 11.04 etc...)" should probably be removed since it is not
true for the current active release "13.07"
Alternatively, a more radical change that makes it much clearer by
eliminating Major Release Number which has a commonly understood usage
within Apache that is different.
"The naming convention for OFBiz releases is <Release Freeze
Date>.<Release Number> for example <13.07>.<04> where:"
<Release Freeze Date> is in the format of <YY.MM> where YY and MM are
the year and month of the date of the feature freeze;
<Release Number> is a two digit sequential number: 01 (if specified) is
the first release from the branch; 02 is the second etc...; for a given
Release Freeze Date you should always use the release with the highest
Release Freeze Date because it represents the latest bug fix release for
the Release Freeze Date you are using.
The creation of the release branch is an internal process of no concern
to the user so just referring to the feature freeze is sufficient.
This section needs to be updated since 13.07.01 and 13.07.02 are not
released.
"Tentative release schedule for the 13.07 series:
June 2014 - Apache OFBiz 13.07.01
August 2014 - Apache OFBiz 13.07.02
March 2015 - Apache OFBiz 13.07.03
September 2015 - Apache OFBiz 13.07.04
April 2016 - Apache OFBiz 13.07.05 (last release of the 13.07 series)"
I gather that this page will be updated soon, so it would be a good time
to fix these as well.
Jacopo
