download: document version numbering scheme
PATCH 1/1 download: document version numbering scheme
The new version numbering scheme was mentioned in the blog post announcing 3.0 previously, but this will fall out of view over time. It is thus preferrable to mention this on the download page too.
Reported-by Marc-André Lureau <[email protected]>
Signed-off-by Daniel P. Berrangé <[email protected]>
--- download.html | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+)
download.html +25 -0
@@ -39,6 +39,31 @@ permalink: /download/ {% include_relative _download/source.html %} </article> </div> + +<h2>Version numbering</h2> +<div> + <p> + In 2018, for the QEMU 3.0 release, a time based version numbering scheme was + adopted: + </p> +<ul> +<dt>major</dt> +<dd>incremented by 1 for the first release of the year</dd> +<dt>minor</dt> +<dd>reset to 0 with every major increment, otherwise incremented by 1 for each release from git master</dd> +<dt>micro</dt> +<dd>always 0 for releases from git master, incremented by 1 for each stable branch release</dd> +</ul> + <p> + The implication of this is that changes in major version number + <strong>do not</strong> have any bearing on the scope of changes + included in the release. Non-backward compatible changes may be made + in any master branch release, provided they have followed the + <a href="https://qemu.weilnetz.de/doc/qemu-doc.html#Deprecated-features">deprecation policy</a> + which calls for warnings to be emitted for a minimum of two releases + prior to the change. + </p> +</div> <script> function animateOnClick(jqThis, slide) { $('.horiz-menu li').removeClass('active');
Signature · 1 line
2.19.2
Quoted 16 lines · Daniel P. Berrangé
The new version numbering scheme was mentioned in the blog post announcing 3.0 previously, but this will fall out of view over time. It is thus preferrable to mention this on the download page too.
Reported-by Marc-André Lureau <[email protected]>Signed-off-by Daniel P. Berrangé <[email protected]>--- download.html | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+)download.html +0
-0
download.html permalink: /download/ · line 47
Quoted 9 lines
download.html +6
-0@@ -39,6 +39,31 @@ permalink: /download/ {% include_relative _download/source.html %} </article> </div> + +<h2>Version numbering</h2> +<div> + <p> + In 2018, for the QEMU 3.0 release, a time based version numbering scheme was + adopted:
I'd maybe drop the "2018" here, and use a three digit version number (since you describe the three digits below) ... maybe rather write it like this:
Since version 3.0.0, QEMU uses a time based version numbering scheme:
?
Quoted 13 lines
download.html +12
-0+ </p> +<ul> +<dt>major</dt> +<dd>incremented by 1 for the first release of the year</dd> +<dt>minor</dt> +<dd>reset to 0 with every major increment, otherwise incremented by 1 for each release from git master</dd> +<dt>micro</dt> +<dd>always 0 for releases from git master, incremented by 1 for each stable branch release</dd> +</ul> + <p> + The implication of this is that changes in major version number + <strong>do not</strong> have any bearing on the scope of changes
download.html permalink: /download/ · line 69
Quoted 10 lines
download.html +7
-0+ included in the release. Non-backward compatible changes may be made + in any master branch release, provided they have followed the + <a href="https://qemu.weilnetz.de/doc/qemu-doc.html#Deprecated-features">deprecation policy</a> + which calls for warnings to be emitted for a minimum of two releases + prior to the change. + </p> +</div> <script> function animateOnClick(jqThis, slide) { $('.horiz-menu li').removeClass('active');
Thomas
Quoted 8 lines · Daniel P. Berrangé
The new version numbering scheme was mentioned in the blog post announcing 3.0 previously, but this will fall out of view over time. It is thus preferrable to mention this on the download page too.
Reported-by Marc-André Lureau <[email protected]>Signed-off-by Daniel P. Berrangé <[email protected]>
Thanks for the clarification. (It should be displayed under the os menu/carousel on https://www.qemu.org/download/)
Reviewed-by Marc-André Lureau <[email protected]>
Quoted 43 lines
--- download.html | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+)download.html +25
-1@@ -39,6 +39,31 @@ permalink: /download/ {% include_relative _download/source.html %} </article> </div> + +<h2>Version numbering</h2> +<div> + <p> + In 2018, for the QEMU 3.0 release, a time based version numbering scheme was + adopted: + </p> +<ul> +<dt>major</dt> +<dd>incremented by 1 for the first release of the year</dd> +<dt>minor</dt> +<dd>reset to 0 with every major increment, otherwise incremented by 1 for each release from git master</dd> +<dt>micro</dt> +<dd>always 0 for releases from git master, incremented by 1 for each stable branch release</dd> +</ul> + <p> + The implication of this is that changes in major version number + <strong>do not</strong> have any bearing on the scope of changes + included in the release. Non-backward compatible changes may be made + in any master branch release, provided they have followed the + <a href="https://qemu.weilnetz.de/doc/qemu-doc.html#Deprecated-features">deprecation policy</a> + which calls for warnings to be emitted for a minimum of two releases + prior to the change. + </p> +</div> <script> function animateOnClick(jqThis, slide) { $('.horiz-menu li').removeClass('active'); --2.19.2