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

[Paolo Bonzini <pbonzini@redhat.com>]

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