From e12ea4bb861fa4abca11da04a896ab2d41bf98bf Mon Sep 17 00:00:00 2001 From: Quentin Young Date: Mon, 17 Sep 2018 16:48:11 +0000 Subject: [PATCH] doc: document CLI deprecation period length Signed-off-by: Quentin Young --- doc/developer/workflow.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/doc/developer/workflow.rst b/doc/developer/workflow.rst index d316de0f38..ee7592fd6a 100644 --- a/doc/developer/workflow.rst +++ b/doc/developer/workflow.rst @@ -778,6 +778,8 @@ That said, compatibility measures can (and should) be removed when either: - some measure of time (dependent on the specific case) has passed, so that the compatibility grace period is considered expired. +For CLI commands, the deprecation period is 1 year. + In all cases, compatibility pieces should be marked with compiler/preprocessor annotations to print warnings at compile time, pointing to the appropriate update path. A ``-Werror`` build should fail if compatibility bits are used. To -- 2.39.5