diff --git a/docs/main/updating/plugins/9-0.md b/docs/main/updating/plugins/9-0.md
index 97014325e..0c1480b60 100644
--- a/docs/main/updating/plugins/9-0.md
+++ b/docs/main/updating/plugins/9-0.md
@@ -6,6 +6,24 @@ slug: /updating/plugins/9-0
 
 # Breaking changes in code
 
+## Android
+
+The `@NativePlugin` annotation and several deprecated permission and activity-result APIs from that era have been removed. For the overall migration pattern, see the [Capacitor 3 plugin migration guide](/updating/plugins/3-0).
+
+| Removed | Replacement |
+| :------ | :---------- |
+| `@NativePlugin` annotation | `@CapacitorPlugin` |
+| `Plugin.saveCall(PluginCall)` | `Bridge.saveCall(PluginCall)` or `PluginCall.setKeepAlive(true)` |
+| `Plugin.getSavedCall()` (no-arg) | `Bridge.getSavedCall(String)` |
+| `Plugin.freeSavedCall()` | `PluginCall.release(Bridge)` |
+| `Plugin.hasDefinedPermissions(String[])` | `Plugin.isPermissionDeclared(String)` |
+| `Plugin.hasPermission(String)` | `Plugin.getPermissionState(String)` / `getPermissionStates()`, or `ActivityCompat.checkSelfPermission(Context, String)` |
+| `Plugin.pluginRequestPermission(String, int)` | `Plugin.requestPermissionForAlias(...)` with `@PermissionCallback` |
+| `Plugin.pluginRequestPermissions(String[], int)` | `Plugin.requestPermissionForAliases(...)` with `@PermissionCallback` |
+| `Plugin.pluginRequestAllPermissions()` | `Plugin.requestAllPermissions(PluginCall, String)` with `@PermissionCallback` |
+| `Plugin.startActivityForResult(PluginCall, Intent, int)` | `Plugin.startActivityForResult(PluginCall, Intent, String)` with `@ActivityCallback` |
+| `Bridge.startActivityForPluginWithResult(PluginCall, Intent, int)` | `Plugin.startActivityForResult(PluginCall, Intent, String)` with `@ActivityCallback` |
+
 # Updating Capacitor to 9.0 in your plugin
 
 :::note
diff --git a/docs/plugins/creating-plugins/android-guide.md b/docs/plugins/creating-plugins/android-guide.md
index 92db9de2b..55de6d183 100644
--- a/docs/plugins/creating-plugins/android-guide.md
+++ b/docs/plugins/creating-plugins/android-guide.md
@@ -139,7 +139,7 @@ Before following this section, make sure you've set up your permission aliases a
 
 ### Annotation Changes
 
-> Still using `@NativePlugin`? See the [upgrade guide](/main/updating/plugins/3-0.md#use-the-new-capacitorplugin-annotation) to switch to `@CapacitorPlugin`.
+> The `@NativePlugin` annotation was removed in Capacitor 9. If your plugin still uses it, see the [upgrade guide](/main/updating/plugins/3-0.md#use-the-new-capacitorplugin-annotation) to switch to `@CapacitorPlugin`.
 
 ```diff
  @CapacitorPlugin(