[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH] qemu-deprecated: Remove text about Python 2
From: |
Markus Armbruster |
Subject: |
Re: [PATCH] qemu-deprecated: Remove text about Python 2 |
Date: |
Wed, 15 Jan 2020 17:04:44 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/26.3 (gnu/linux) |
Daniel P. Berrangé <address@hidden> writes:
> On Tue, Jan 14, 2020 at 11:08:16AM +0100, Thomas Huth wrote:
>> On 13/01/2020 23.36, John Snow wrote:
>> > Right now, we don't
>> > really have these docs hosted in a searchable way online in a
>> > per-version format. Once the notice is gone, it's gone from the mirror.
>> >
>> > I removed some bitmap functionality not too long ago and I created a
>> > "Recently Removed" section as a bit of a troubleshooting guide should it
>> > be needed.
>> >
>> > - Do we want this section?
>> > - Should I remove it?
>> > - Can we add historical docs to the website to see previous deprecated
>> > docs in a searchable manner?
>>
>> I also once started a page in the Wiki here:
>>
>> https://wiki.qemu.org/Features/RemovedFeatures
>>
>> ... but apparently, it did not get enough attention yet, otherwise you
>> would have noticed it before introducing the new chapter into the
>> qemu-doc ...
>>
>> We definitely need one spot where we can document removed features. I
>> don't mind which way we do it, either the qemu-doc or the wiki, but we
>> should unify on one of the two. I guess the qemu-doc is the better place
>> since we are tracking the deprecated features there already and one more
>> or less just has to move the text to the other chapter when things get
>> finally removed?
>
> Yeah, I've said in the past that we should not be deleting deprecations
> from the docs entirely.
>
> If you look at GTK docs for example, you'll see they keep a record of
> all incompatible or noteworth changes between release:
>
> https://developer.gnome.org/gtk3/stable/gtk-migrating-3-x-to-y.html
>
> IMHO, we should follow this and have an appendix of removed features,
> with sub-sections per QEMU release listing each removed feature. Thus
> deprecation docs just get moved to this appendix at the right time.
This is exactly the "Recently Removed" appendix John added in commit
3264ffced3d.
Now we need a sucker^Wvolunteer to restore all the stuff we dropped from
appendix "Deprecated features" to this appendix. John, you were
incautious enough to signal you care; what about you?
Re: [PATCH] qemu-deprecated: Remove text about Python 2, Philippe Mathieu-Daudé, 2020/01/30