[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] [qemu-web PATCH v2] Add a blog post about deprecation o
From: |
Paolo Bonzini |
Subject: |
Re: [Qemu-devel] [qemu-web PATCH v2] Add a blog post about deprecation of old interfaces and features |
Date: |
Thu, 10 Aug 2017 11:24:44 +0200 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.2.1 |
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 <address@hidden>
>> ---
>> 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