- adds upgrade guidance for inherited odata methods

Author: baywet

docs/upgrade-to-v3.md

@@ -272,6 +272,24 @@ The SDK now produces methods to include the count of items included in collectio
 
 > Note: support for `filter`, `orderBy`, `top`, `skip`, `skipToken`, and `expand` was also added in the last 2.X versions, if you are upgrading from an older version you might want to consider updating the use of query options by these new methods.
 
+## Support for inherited OData methods
+
+The SDK now produces methods in child request builder types for the parents' OData methods (actions & functions). This change allows you to write more specific requests reducing the permissions required for your application.
+
+Replacing
+
+```Java
+    graphClient.directoryObjects("userId").getMemberGroups(<...>).buildRequest().post();
+```
+
+By
+
+```Java
+    graphClient.users("userId").getMemberGroups(<...>).buildRequest().post();
+```
+
+Your application now only needs **User.Read.All** instead of **Directory.Read.All**.
+
 ### JavaDoc improvements and Nullability annotations
 
 Multiple improvements to the JavaDoc and annotations (`@Nullable`, `@Nonnull`) have been added to improve the developement experience for Java and Kotlin developers.