[openstack-dev] [fuel] Deprecation and backwards compaibility Policy

Andrew Woodward xarses at gmail.com
Mon Jun 29 23:22:58 UTC 2015


Some recent specs have proposed changing some of the API's by either
removing parts, or changing them in non-backwards way. Additionally there
are some proposals that are light on details of their impact to already
supported components.

I propose that deprecation and backwards compatibility should be maintained
for at least one release before removing support for the previous
implementation.

This would result in a process such as

A -> A2,B -> B
R1 -> R2    -> R3

Where
A is the initial implementation
A2 is the depricated A interface that likely converts to B back to A
B is the new feature

R[1,2,3] Releases incrementing.

This would require that the interface A is documented in the release notes
of R2 as being marked for removal. The A interface can then be removed in
R3.

This will allow for a reasonable time for down-stream users to learn that
the interface they may be using is going away and they can adapt to the new
interface before it's the only interface available.

-- 

--

Andrew Woodward

Mirantis

Fuel Community Ambassador

Ceph Community
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150629/374828d4/attachment.html>


More information about the OpenStack-dev mailing list