Apply review feedback.

Author: mvanbeusekom

packages/camera/camera/example/ios/RunnerTests/MockFLTThreadSafeFlutterResult.h

@@ -19,7 +19,7 @@
  * The expectation is fullfilled when a result is called allowing tests to await the result in an
  * asynchronous manner.
  */
-- (instancetype _Nonnull)initWithExpectation:(nonnull XCTestExpectation *)expectation;
+- (nonnull instancetype)initWithExpectation:(nonnull XCTestExpectation *)expectation;
 @end
 
 #endif /* MockFLTThreadSafeFlutterResult_h */

packages/camera/camera/ios/Classes/CameraPlugin_Test.h

@@ -18,13 +18,16 @@
 /// Hide the default public constructor.
 - (instancetype)init NS_UNAVAILABLE;
 
-/// Exposes the [CameraPlugin handleMethodCallAsync:result:] method for unit testing.
-///
-/// This method should always be dispatched on a background queue to prevent deadlocks.
 
+/// Handles `FlutterMethodCall`s and ensures result is send on the main dispatch queue.
+///
+/// @param call The method call command object.
+/// @param result A wrapper around the `FlutterResult` callback which ensures the callback is called on the main dispatch queue.
 - (void)handleMethodCallAsync:(FlutterMethodCall *)call result:(FLTThreadSafeFlutterResult *)result;
 
-/// Exposes the [CameraPlugin orientationChanged:] method for unit testing.
+/// Called by the @c NSNotificationManager each time the device's orientation is changed.
+///
+/// @param notification @c NSNotification instance containing a reference to the `UIDevice` object that triggered the orientation change.
 - (void)orientationChanged:(NSNotification *)notification;
 
 @end