[cloud_functions] Update README and dart docs, remove unused paramete…

…rs. (firebase#1620)

packages/cloud_functions/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.4.0
+
+* Removed unused `parameters` param from `getHttpsCallable`.
+
 ## 0.3.0+1
 
 * Update iOS dependencies to latest.

packages/cloud_functions/README.md

@@ -29,10 +29,26 @@ with Xcode, and within Xcode place the file inside ios/Runner. Don't follow the
 import 'package:cloud_functions/cloud_functions.dart';
 ```
 
-Calling a function:
+Getting an instance of the callable function:
 
 ```dart
-dynamic resp = await CloudFunctions.instance.getHttpsCallable(functionName: 'YOUR_CALLABLE_FUNCTION_NAME').call();
+final HttpsCallable callable = CloudFunctions.instance.getHttpsCallable(
+    functionName: 'YOUR_CALLABLE_FUNCTION_NAME',
+);
+```
+
+Calling the function:
+
+```dart
+dynamic resp = await callable.call();
+```
+
+Calling the function with parameters:
+
+```dart
+dynamic resp = await callable.call(<String, dynamic>{
+    'YOUR_PARAMETER_NAME': 'YOUR_PARAMETER_VALUE',
+});
 ```
 
 ## Getting Started

packages/cloud_functions/lib/src/cloud_functions.dart

@@ -31,12 +31,12 @@ class CloudFunctions {
 
   final String _region;
 
-  /// Executes this Callable HTTPS trigger asynchronously.
+  /// Gets an instance of a Callable HTTPS trigger in Cloud Functions.
   ///
-  /// @param functionName The name of the callable function being triggered.
-  /// @param parameters Parameters to be passed to the callable function.
-  HttpsCallable getHttpsCallable(
-      {@required String functionName, Map<String, dynamic> parameters}) {
+  /// Can then be executed by calling `call()` on it.
+  ///
+  /// @param functionName The name of the callable function.
+  HttpsCallable getHttpsCallable({@required String functionName}) {
     return HttpsCallable._(this, functionName);
   }
 }

packages/cloud_functions/pubspec.yaml

@@ -1,6 +1,6 @@
 name: cloud_functions
 description: Flutter plugin for Cloud Functions.
-version: 0.3.0+1
+version: 0.4.0
 author: Flutter Team <[email protected]>
 homepage: https://github.com/flutter/plugins/tree/master/packages/cloud_functions