Merge "Update the NDK API Council landing page." into main
diff --git a/api-guidelines/ndk.md b/api-guidelines/ndk.md
index bfad741..d91c3b2 100644
--- a/api-guidelines/ndk.md
+++ b/api-guidelines/ndk.md
@@ -32,6 +32,14 @@
behavior of that API **must not be changed**. This is a difficult guaranatee to
uphold, and that's why these rules are in place.
+For the duration of the compatibility window, the implementation of the API must
+remain, and must avoid significant behavior changes. Stable APIs can almost
+never be truly removed (if your API is less broken than `invoke_cve()`, it
+probably can't be removed). To discourage developers from using an API you can
+annotate it with `__DEPRECATED_IN(api_level, message)`, but that should never be
+done without an alternative for callers to migrate to, and doing so does not
+allow you to remove or significantly alter the implementation.
+
## API Rules {#rules}
One of the difficulties in concrete rules is applying them to a platform that
