Merge remote-tracking branch 'refs/remotes/origin/master' into dev

Author: Caitlin Bales (MSFT)

docs/custom-queries.md

@@ -0,0 +1,25 @@
+# Making Custom Calls to Graph
+
+The Graph SDK attempts to enable all available scenarios through Microsoft Graph. There are times, however, through errors or custom Graph functionality, that makes calling the desired endpoint is not possible through the provided requests and builders.
+
+## Creating a custom request
+You can extend BaseRequest to create a custom request:
+
+```Java
+public class CustomRequest extends BaseRequest {
+
+    public CustomRequest(final String requestUrl, final IBaseClient client, final java.util.List<Option> requestOptions) {
+        super(requestUrl, client, requestOptions, Void.class);
+    }
+
+    public String get() throws ClientException {
+        return send(HttpMethod.GET, null);
+    }
+}
+```
+Then you can instantiate a new request to use to call Graph:
+
+```Java
+CustomRequest request = new CustomRequest("https://graph.microsoft.com/v1.0/custom", graphServiceClient, requestOptions);
+request.get();
+```

docs/known-issues.md

@@ -0,0 +1,8 @@
+# Known Issues
+Because of our close partnership with workload teams who surface API functionality through Graph, it is not always appropriate or feasible to introduce fixes to missing or broken functionality.
+
+## No Annotation Support
+[OData](http://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/part3-csdl/odata-v4.0-errata03-os-part3-csdl-complete.html#_Toc453752630) allows workloads to specify additional information about their API surface including both functional and non-functional stipulations. We currently do not support these annotations in the [Generator](https://github.com/microsoftgraph/MSGraph-SDK-Code-Generator), due to hierarchical inheritance issues regarding said annotations. Therefore, there may be methods that do not produce valid queries to Graph. Please refer to the [Graph Docs](https://developer.microsoft.com/en-us/graph/docs/concepts/overview) as the source of truth in these discrepancies.
+
+## PATCH of OneNote Pages
+OneNote currently defines the ability to PATCH a page's content (```PATCH https://graph.microsoft.com/v1.0/me/onenote/pages/id/content```), which is currently not supported by the Android SDK. If you are looking to PATCH JSON to a page, you can use the ```getOnenotePatchContent``` method to submit JSON data. If you are looking to PATCH multipart data, you cannot use the request builders given. Refer to the [documentation on making custom queries](https://github.com/microsoftgraph/msgraph-sdk-android/blob/master/docs/custom-queries.md) using the SDK.