Re: [PATCH] docs/system: clarify deprecation scheduled

2020-09-15 Thread Stefan Hajnoczi
On Mon, Sep 14, 2020 at 03:21:46PM +0100, Daniel P. Berrangé wrote: > On Tue, Aug 11, 2020 at 11:47:36AM +0100, Stefan Hajnoczi wrote: > > The sentence explaining the deprecation schedule is ambiguous. Make it > > clear that a feature deprecated in the Nth release is guaranteed to > > remain

Re: [PATCH] docs/system: clarify deprecation scheduled

2020-09-14 Thread Peter Maydell
On Mon, 14 Sep 2020 at 15:22, Daniel P. Berrangé wrote: > So we're changing > > The feature will remain functional for 2 releases prior to actual removal. > > to > > The feature will remain functional for 1 more release after deprecation. > > How about > > The feature will remain functional

Re: [PATCH] docs/system: clarify deprecation scheduled

2020-09-14 Thread Eric Blake
On 9/14/20 9:21 AM, Daniel P. Berrangé wrote: On Tue, Aug 11, 2020 at 11:47:36AM +0100, Stefan Hajnoczi wrote: The sentence explaining the deprecation schedule is ambiguous. Make it clear that a feature deprecated in the Nth release is guaranteed to remain available in the N+1th release.

Re: [PATCH] docs/system: clarify deprecation scheduled

2020-09-14 Thread Daniel P . Berrangé
On Tue, Aug 11, 2020 at 11:47:36AM +0100, Stefan Hajnoczi wrote: > The sentence explaining the deprecation schedule is ambiguous. Make it > clear that a feature deprecated in the Nth release is guaranteed to > remain available in the N+1th release. Removal can occur in the N+2nd > release or

Re: [PATCH] docs/system: clarify deprecation scheduled

2020-09-14 Thread Stefan Hajnoczi
On Tue, Aug 11, 2020 at 11:47:36AM +0100, Stefan Hajnoczi wrote: > The sentence explaining the deprecation schedule is ambiguous. Make it > clear that a feature deprecated in the Nth release is guaranteed to > remain available in the N+1th release. Removal can occur in the N+2nd > release or

[PATCH] docs/system: clarify deprecation scheduled

2020-08-11 Thread Stefan Hajnoczi
The sentence explaining the deprecation schedule is ambiguous. Make it clear that a feature deprecated in the Nth release is guaranteed to remain available in the N+1th release. Removal can occur in the N+2nd release or later. As an example of this in action, see commit