doc: make RTE_NEXT_ABI optional in guidelines
authorFerruh Yigit <ferruh.yigit@intel.com>
Fri, 1 Mar 2019 17:32:49 +0000 (17:32 +0000)
committerThomas Monjalon <thomas@monjalon.net>
Wed, 27 Mar 2019 13:22:44 +0000 (14:22 +0100)
commite17e6d31ca66d977a6a212b1c612c9b8f2cc166b
tree092698f12064314a5e24baf6f4ba1f247af88946
parentac8342a8a61d6934a917a81ea46e4bc194fb5426
doc: make RTE_NEXT_ABI optional in guidelines

Initial process requires oncoming changes described in deprecation
notice should be implemented in a RTE_NEXT_ABI gated way.

This has been discussed in technical board, and since this can cause a
multiple #ifdef blocks in multiple locations of the code, can be
confusing specially for the modifications that requires data structure
changes. Anyway this was not happening in practice.

Making RTE_NEXT_ABI usage more optional based on techboard decision:
http://mails.dpdk.org/archives/dev/2019-January/123519.html

The intention with using RTE_NEXT_ABI was to provide more information
to the user about planned changes, and force developer to think more in
coding level. Since RTE_NEXT_ABI become optional, now the preferred way
to do this is, if possible, sending changes, described in deprecation
notice, as a separate patch and reference it in deprecation notice.

Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>
Acked-by: Neil Horman <nhorman@tuxdriver.com>
Acked-by: Kevin Traynor <ktraynor@redhat.com>
doc/guides/contributing/versioning.rst