[Qemu-devel] [qemu-web PATCH v2] Add a blog post about deprecation of old interfaces and features

[Qemu-devel] [qemu-web PATCH v2] Add a blog post about deprecation of old interfaces and features

[Thomas Huth]

Now that we've got a list of deprecated interfaces/features in the QEMU
documentation, it is time to draw some more public attention to our plans
of removing certain interfaces/features in future releases.

Signed-off-by: Thomas Huth <thuth@redhat.com>
---
 v2: Use a link to the qemu-doc instead of pointing to the Wiki

 _posts/2017-08-10-deprecation.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 _posts/2017-08-10-deprecation.md

diff --git a/_posts/2017-08-10-deprecation.md b/_posts/2017-08-10-deprecation.md
new file mode 100644
index 0000000..784fb79
--- /dev/null
+++ b/_posts/2017-08-10-deprecation.md
@@ -0,0 +1,26 @@
+---
+layout: post
+title:  "Deprecation of old parameters and features"
+date:   2017-08-10 10:45:00 +0200
+author: Thomas Huth
+categories: [features, 'web site']
+---
+QEMU has a lot of interfaces (like command line options or HMP commands) and
+old features (like certain devices) which are considered as deprecated
+since other more generic or better interfaces/features have been established
+instead. While the QEMU developers are generally trying to keep each QEMU
+release compatible with the previous ones, the old legacy sometimes gets into
+the way when developing new code and/or causes quite some burden of maintaining
+it.
+
+Thus we are currently considering to get rid of some of the old interfaces
+and features in a future release and have started to collect a list of such
+old items in our
+[QEMU documentation](https://qemu.weilnetz.de/doc/qemu-doc.html#Deprecated-features).
+If you are running QEMU directly, please have a look at this deprecation
+chapter of the QEMU documentation to see whether you are still using one of
+these old interfaces or features, so you can adapt your setup to use the new
+interfaces/features instead. Or if you rather think that one of the items
+should *not* be removed from QEMU at all, please speak up on the
+[qemu-devel mailing list](http://wiki.qemu.org/Contribute/MailingLists)
+to explain why the interface or feature is still required.
-- 
1.8.3.1

Re: [Qemu-devel] [qemu-web PATCH v2] Add a blog post about deprecation of old interfaces and features

[Paolo Bonzini]

On 10/08/2017 10:46, Thomas Huth wrote:
> Now that we've got a list of deprecated interfaces/features in the QEMU
> documentation, it is time to draw some more public attention to our plans
> of removing certain interfaces/features in future releases.
> 
> Signed-off-by: Thomas Huth <thuth@redhat.com>
> ---
>  v2: Use a link to the qemu-doc instead of pointing to the Wiki
> 
>  _posts/2017-08-10-deprecation.md | 26 ++++++++++++++++++++++++++
>  1 file changed, 26 insertions(+)
>  create mode 100644 _posts/2017-08-10-deprecation.md
> 
> diff --git a/_posts/2017-08-10-deprecation.md b/_posts/2017-08-10-deprecation.md
> new file mode 100644
> index 0000000..784fb79
> --- /dev/null
> +++ b/_posts/2017-08-10-deprecation.md
> @@ -0,0 +1,26 @@
> +---
> +layout: post
> +title:  "Deprecation of old parameters and features"
> +date:   2017-08-10 10:45:00 +0200
> +author: Thomas Huth
> +categories: [features, 'web site']
> +---
> +QEMU has a lot of interfaces (like command line options or HMP commands) and
> +old features (like certain devices) which are considered as deprecated
> +since other more generic or better interfaces/features have been established
> +instead. While the QEMU developers are generally trying to keep each QEMU
> +release compatible with the previous ones, the old legacy sometimes gets into
> +the way when developing new code and/or causes quite some burden of maintaining
> +it.
> +
> +Thus we are currently considering to get rid of some of the old interfaces
> +and features in a future release and have started to collect a list of such
> +old items in our
> +[QEMU documentation](https://qemu.weilnetz.de/doc/qemu-doc.html#Deprecated-features).
> +If you are running QEMU directly, please have a look at this deprecation
> +chapter of the QEMU documentation to see whether you are still using one of
> +these old interfaces or features, so you can adapt your setup to use the new
> +interfaces/features instead. Or if you rather think that one of the items
> +should *not* be removed from QEMU at all, please speak up on the
> +[qemu-devel mailing list](http://wiki.qemu.org/Contribute/MailingLists)
> +to explain why the interface or feature is still required.
> 

Pushed, thanks.

Paolo

Re: [Qemu-devel] [qemu-web PATCH v2] Add a blog post about deprecation of old interfaces and features

[Daniel P. Berrange]

On Thu, Aug 10, 2017 at 10:46:30AM +0200, Thomas Huth wrote:
> Now that we've got a list of deprecated interfaces/features in the QEMU
> documentation, it is time to draw some more public attention to our plans
> of removing certain interfaces/features in future releases.
> 
> Signed-off-by: Thomas Huth <thuth@redhat.com>
> ---
>  v2: Use a link to the qemu-doc instead of pointing to the Wiki
> 
>  _posts/2017-08-10-deprecation.md | 26 ++++++++++++++++++++++++++
>  1 file changed, 26 insertions(+)
>  create mode 100644 _posts/2017-08-10-deprecation.md
> 
> diff --git a/_posts/2017-08-10-deprecation.md b/_posts/2017-08-10-deprecation.md
> new file mode 100644
> index 0000000..784fb79
> --- /dev/null
> +++ b/_posts/2017-08-10-deprecation.md
> @@ -0,0 +1,26 @@
> +---
> +layout: post
> +title:  "Deprecation of old parameters and features"
> +date:   2017-08-10 10:45:00 +0200
> +author: Thomas Huth
> +categories: [features, 'web site']
> +---
> +QEMU has a lot of interfaces (like command line options or HMP commands) and
> +old features (like certain devices) which are considered as deprecated
> +since other more generic or better interfaces/features have been established
> +instead. While the QEMU developers are generally trying to keep each QEMU
> +release compatible with the previous ones, the old legacy sometimes gets into
> +the way when developing new code and/or causes quite some burden of maintaining
> +it.
> +
> +Thus we are currently considering to get rid of some of the old interfaces
> +and features in a future release and have started to collect a list of such
> +old items in our
> +[QEMU documentation](https://qemu.weilnetz.de/doc/qemu-doc.html#Deprecated-features).

Unrelated to your post - it would be nice to have the qemu docs hosted
on qemu.org, and even nicer if someone figures out how to theme them
to fit in with the website style instead of being bare black & white
pages with no navigation :-)



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

Re: [Qemu-devel] [qemu-web PATCH v2] Add a blog post about deprecation of old interfaces and features

[Paolo Bonzini]

On 10/08/2017 11:23, Daniel P. Berrange wrote:
> On Thu, Aug 10, 2017 at 10:46:30AM +0200, Thomas Huth wrote:
>> Now that we've got a list of deprecated interfaces/features in the QEMU
>> documentation, it is time to draw some more public attention to our plans
>> of removing certain interfaces/features in future releases.
>>
>> Signed-off-by: Thomas Huth <thuth@redhat.com>
>> ---
>>  v2: Use a link to the qemu-doc instead of pointing to the Wiki
>>
>>  _posts/2017-08-10-deprecation.md | 26 ++++++++++++++++++++++++++
>>  1 file changed, 26 insertions(+)
>>  create mode 100644 _posts/2017-08-10-deprecation.md
>>
>> diff --git a/_posts/2017-08-10-deprecation.md b/_posts/2017-08-10-deprecation.md
>> new file mode 100644
>> index 0000000..784fb79
>> --- /dev/null
>> +++ b/_posts/2017-08-10-deprecation.md
>> @@ -0,0 +1,26 @@
>> +---
>> +layout: post
>> +title:  "Deprecation of old parameters and features"
>> +date:   2017-08-10 10:45:00 +0200
>> +author: Thomas Huth
>> +categories: [features, 'web site']
>> +---
>> +QEMU has a lot of interfaces (like command line options or HMP commands) and
>> +old features (like certain devices) which are considered as deprecated
>> +since other more generic or better interfaces/features have been established
>> +instead. While the QEMU developers are generally trying to keep each QEMU
>> +release compatible with the previous ones, the old legacy sometimes gets into
>> +the way when developing new code and/or causes quite some burden of maintaining
>> +it.
>> +
>> +Thus we are currently considering to get rid of some of the old interfaces
>> +and features in a future release and have started to collect a list of such
>> +old items in our
>> +[QEMU documentation](https://qemu.weilnetz.de/doc/qemu-doc.html#Deprecated-features).
> 
> Unrelated to your post - it would be nice to have the qemu docs hosted
> on qemu.org, and even nicer if someone figures out how to theme them
> to fit in with the website style instead of being bare black & white
> pages with no navigation :-)

My hope is still to host them on readthedocs sooner or later (though
then they'd have the readthedocs theme).

Paolo