doc: api_lifecycle: Use DEPRECATED instead of LEGACY in Kconfig

Recommend that Kconfig symbols related to deprecated features use
'DEPRECATED' in the symbol name instead of 'LEGACY'.

Signed-off-by: Kumar Gala <kumar.gala@linaro.org>