Re: [Qemu-devel] [PATCH RFC] docs: document support lifetime and deprecation policy

[Daniel P. Berrange]

On Wed, May 10, 2017 at 12:39:02PM -0400, Stefan Hajnoczi wrote:
> On Wed, May 10, 2017 at 12:15:35PM +0100, Daniel P. Berrange wrote:
> > The deprecation of features in QEMU is totally adhoc currently,
> > with no way for the user to get a list of what is deprecated
> > in each release. There is also no guidance on the duration of
> > support for features such as versioned machine types, which
> > have a finite useful life.
> > 
> > This adds two new appendix entries to the main QEMU documentation.
> > The first appendix lists items which have finite lifecycles,
> > and sets out the policy that is used for deprecating & removing
> > features which have indefinite lifecycles. The second appendix
> > provides a list of all[1] currently deprecated features, along
> > with the release they were deprecated in.
> > 
> > Signed-off-by: Daniel P. Berrange <address@hidden>
> > 
> > [1] This is a lie. I've only listed one deprecated feature. Once
> >     we agree on the general concept, we can fill out the doc
> >     with the rest of the currently deprecated features.
> > ---
> >  qemu-doc.texi | 47 +++++++++++++++++++++++++++++++++++++++++++++++
> >  1 file changed, 47 insertions(+)
> 
> Peter maydell is away in May.  He usually participates in discussions on
> this topic.  Unless there are urgent issues I suggest we wait until June
> to commit QEMU to new policies.

That's fine with me.

I just sent this because of the 'deprecate machine types' patch.

IMHO, we should decide on this general policy first, and only then
deprecate machine types in accordance with agreed policy, rather
than do an aribtrary deprecation of a bunch of machine types with
no clear idea of why we're picking them.



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 :|