Updated readme examples based on changes, and added clarity in places.

README.md

@@ -69,9 +69,11 @@ var basicAuthentication = Rest.GetBasicAuthentication("username", "password");
 var bearerToken = Rest.GetBearerOAuthToken("authToken");
 ```
 
+These methods will generate the necessary data to apply to your authentication headers, they DO NOT set the authentication for any Rest calls.
+
 ### Rest Parameters
 
-Rest parameters have been bundled into a single object to make the method signatures a bit more uniform.
+Rest parameters have been bundled into a single object to make the method signatures a bit more uniform, these can be provided with all requests made using the `com.utilities.rest` library to control how the operation performs.
 
 ```csharp
 var restParameters = new RestParameters(
@@ -84,9 +86,15 @@ var restParameters = new RestParameters(
  disposeCertificateHandler, // Optional, dispose the CertificateHandler. Default is true.
  cacheDownloads, // Optional, cache downloaded content. Default is true
  debug); // Optional, enable debug output of the request. Default is false.
+
+// Rest call passing a pre-configured set of RestParameters
 var response = await Rest.GetAsync("www.your.api/endpoint", restParameters);
 ```
 
+If you require any of the above options when making calls, ensure to add a `RestParameters` construct to the request, as shown above.
+
+> Pro Tip: If you have multiple requests using the same "Parameters", then cache a single instance of the `RestParameters` and use this for all calls instead of recreating it for each request.
+
 ### Get
 
 ```csharp
@@ -149,7 +157,7 @@ response.Validate(debug: true);
 ### Delete
 
 ```csharp
-var response = await Rest.DeleteAsync("www.your.api/endpoint", restParameters);
+var response = await Rest.DeleteAsync("www.your.api/endpoint");
 // Validates the response for you and will throw a RestException if the response is unsuccessful.
 response.Validate(debug: true);
 ```
@@ -167,7 +175,7 @@ Debug.Log(Rest.DownloadCacheDirectory);
 // Application.persistentDataPath,
 // Application.dataPath,
 // Application.streamingAssetsPath
-Rest.DownloadCacheDirectory = Application.dataPath;
+Rest.DownloadLocation = Application.dataPath;
 
 var uri = "www.url.to/remote/resource";
 
@@ -194,7 +202,7 @@ Download a file.
 ```csharp
 var downloadedFilePath = await Rest.DownloadFileAsync("www.your.api/your_file.pdf");
 
-if (!string.IsNullOrWhiteSpace(downloadedFilePath))
+if (!string.IsNullOrWhiteSpace(downloadedFilePath) && File.Exists(downloadedFilePath))
 {
  Debug.Log(downloadedFilePath);
 }
@@ -273,11 +281,12 @@ audioSource.clip = audioClip;
 #### Asset Bundles
 
 ```csharp
-var assetBundle = await Rest.DownloadAssetBundleAsync("www.your.api/asset.bundle");
+var bundleOptions = new AssetBundleRequestOptions();
+var assetBundle = await Rest.DownloadAssetBundleAsync("www.your.api/asset.bundle", bundleOptions);
 
 if (assetBundle != null)
 {
- var cube = bundle.LoadAsset<GameObject>("Cube");
+ var cube = assetBundle.LoadAsset<GameObject>("Cube");
  Instantiate(cube);
 }
 ```