diff --git a/doc/develop/api/api_lifecycle.rst b/doc/develop/api/api_lifecycle.rst index 112c9d3722e8..2923451aa020 100644 --- a/doc/develop/api/api_lifecycle.rst +++ b/doc/develop/api/api_lifecycle.rst @@ -236,9 +236,9 @@ The following are the requirements for deprecating an existing API: - Code using the deprecated API needs to be modified to remove usage of said API - The change needs to be atomic and bisectable - - Create a GitHub issue to track the removal of the deprecated API, and - add it to the roadmap targeting the appropriate release - (in the example above, 1.16). + - Add an entry in the corresponding release + `GitHub issue `_ + tracking removal of deprecated APIs. During the deprecation waiting period, the API will be in the ``deprecated`` state. The Zephyr maintainers will track usage of deprecated APIs on