summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTreehugger Robot <android-test-infra-autosubmit@system.gserviceaccount.com>2024-04-22 20:28:38 +0000
committerGerrit Code Review <noreply-gerritcodereview@google.com>2024-04-22 20:28:38 +0000
commit76c5f49d8fed80389488f0b1f9b9d23f59562e05 (patch)
tree5c7dce8a7c777d2a9830700bb6f3920d3b354faa
parent7fa8cf31687b1658af92dd67ebeb97532e1165f0 (diff)
parent10d0ac15add45ec9c8b4e787bc0a2948e034c6eb (diff)
downloaddocs-76c5f49d8fed80389488f0b1f9b9d23f59562e05.tar.gz
Merge "Document the intake form for Android API removal requests" into main
-rw-r--r--api-guidelines/evolution.md8
1 files changed, 2 insertions, 6 deletions
diff --git a/api-guidelines/evolution.md b/api-guidelines/evolution.md
index 414b173..8354d74 100644
--- a/api-guidelines/evolution.md
+++ b/api-guidelines/evolution.md
@@ -220,12 +220,8 @@ to extend a class, abstract methods may still be soft removed.
### Hard removal <a name="hard-removal"></a>
Hard removal is a binary-breaking change and should never occur in public APIs.
-For system APIs, hard removals **must** be preceded by soft removal for the
-duration of a major release. Remove the entire implementation when hard-removing
-APIs.
-
-Tests for hard-removed APIs **must** be removed since they will no longer
-compile otherwise.
+If you have a strong justification for a removal, you can request for approval
+by submitting the 1 pager at go/request-android-api-removal.
### Discouraging {.numbered}