[Qemu-devel] [qemu-web PATCH v2] download: document version numbering scheme

[Qemu-devel] [qemu-web PATCH v2] download: document version numbering scheme

[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 <marcandre.lureau@redhat.com>
Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
---
 download.html | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/download.html b/download.html
index 5a1e4ea..bbdc00c 100644
--- a/download.html
+++ b/download.html
@@ -39,6 +39,30 @@ permalink: /download/
 	{% include_relative _download/source.html %}
 </article>
 </div>
+
+<h2>Version numbering</h2>
+<div>
+  <p>
+  Since version 3.0.0, QEMU uses a time based version numbering scheme:
+  </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

Re: [Qemu-devel] [qemu-web PATCH v2] download: document version numbering scheme

[Thomas Huth]

On 2018-11-28 16:38, Daniel P. Berrangé wrote:
> 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 <marcandre.lureau@redhat.com>
> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
> ---
>  download.html | 24 ++++++++++++++++++++++++
>  1 file changed, 24 insertions(+)
> 
> diff --git a/download.html b/download.html
> index 5a1e4ea..bbdc00c 100644
> --- a/download.html
> +++ b/download.html
> @@ -39,6 +39,30 @@ permalink: /download/
>  	{% include_relative _download/source.html %}
>  </article>
>  </div>
> +
> +<h2>Version numbering</h2>
> +<div>
> +  <p>
> +  Since version 3.0.0, QEMU uses a time based version numbering scheme:
> +  </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>

HTML validator (https://validator.w3.org) complains here:

* Element dt not allowed as child of element ul in this context.

* Element dt not allowed as child of element ul in this context.

Since I don't want to mess up your intended formatting, could you please
fix it on your own and send a v3?

 Thanks,
  Thomas

Re: [Qemu-devel] [qemu-web PATCH v2] download: document version numbering scheme

[Daniel P. Berrangé]

On Thu, Nov 29, 2018 at 11:58:22AM +0100, Thomas Huth wrote:
> On 2018-11-28 16:38, Daniel P. Berrangé wrote:
> > 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 <marcandre.lureau@redhat.com>
> > Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
> > ---
> >  download.html | 24 ++++++++++++++++++++++++
> >  1 file changed, 24 insertions(+)
> > 
> > diff --git a/download.html b/download.html
> > index 5a1e4ea..bbdc00c 100644
> > --- a/download.html
> > +++ b/download.html
> > @@ -39,6 +39,30 @@ permalink: /download/
> >  	{% include_relative _download/source.html %}
> >  </article>
> >  </div>
> > +
> > +<h2>Version numbering</h2>
> > +<div>
> > +  <p>
> > +  Since version 3.0.0, QEMU uses a time based version numbering scheme:
> > +  </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>
> 
> HTML validator (https://validator.w3.org) complains here:
> 
> * Element dt not allowed as child of element ul in this context.
> 
> * Element dt not allowed as child of element ul in this context.

Oh fun, browsers still rendered it correctly despite being wrong :-)

> 
> Since I don't want to mess up your intended formatting, could you please
> fix it on your own and send a v3?

I've sent a v3 with s/ul/dl/ 


Regards,
Daniel
-- 
|: https://berrange.com      -o-    https://www.flickr.com/photos/dberrange :|
|: https://libvirt.org         -o-            https://fstop138.berrange.com :|
|: https://entangle-photo.org    -o-    https://www.instagram.com/dberrange :|