Address some nits

packages/camera/camera/lib/src/camera_controller.dart

@@ -439,9 +439,9 @@ class CameraController extends ValueNotifier<CameraValue> {
 
   /// Sets the description of the camera.
   ///
-  /// On Android, calling this method will normally cancel any active recording.
-  /// To avoid this, start the recording with [startVideoRecording]
-  /// and set `enablePersistentRecording` to `true`.
+  /// On Android, you must start the recording with [startVideoRecording]
+  /// with `enablePersistentRecording` set to `true`
+  /// to avoid cancelling any active recording.
   ///
   /// Throws a [CameraException] if setting the description fails.
   Future<void> setDescription(CameraDescription description) async {

packages/camera/camera_android_camerax/README.md

@@ -34,10 +34,6 @@ use cases, the plugin behaves according to the following:
     video recording and image streaming is supported, but concurrent video recording, image
     streaming, and image capture is not supported.
 
-### setDescriptionWhileRecording
-`setDescriptionWhileRecording`, used to switch cameras while recording video. Calling this method will normally cancel any active recording. 
-To avoid this, start the recording with `startVideoCapturing` and set `enablePersistentRecording` of `VideoCaptureOptions` to `true`.
-
 ### 240p resolution configuration for video recording
 
 240p resolution configuration for video recording is unsupported by CameraX, and thus,
@@ -88,6 +84,12 @@ As of Android 14, to allow for background image streaming, you will need to spec
 </manifest>
 ```
 
+### Notes on video capture
+
+#### Setting description while recording
+To avoid cancelling any active recording when calling `setDescriptionWhileRecording`,
+you must start the recording with `startVideoCapturing` with `enablePersistentRecording` set to `true`.
+
 #### Configuring NV21 image format
 
 If you initialize a `CameraController` with `ImageFormatGroup.nv21`, then streamed images will

packages/camera/camera_android_camerax/example/integration_test/integration_test.dart

@@ -245,11 +245,7 @@ void main() {
     await controller.initialize();
     await controller.prepareForVideoRecording();
 
-    if (Platform.isAndroid) {
-      await controller.startVideoRecording(enablePersistentRecording: true);
-    } else {
-      await controller.startVideoRecording();
-    }
+    await controller.startVideoRecording(enablePersistentRecording: true);
 
     await controller.setDescription(cameras[1]);
 

packages/camera/camera_android_camerax/lib/src/android_camera_camerax.dart

@@ -927,9 +927,9 @@ class AndroidCameraCameraX extends CameraPlatform {
 
   /// Sets the active camera while recording.
   ///
-  /// Calling this method will normally cancel any active recording.
-  /// To avoid this, start the recording with [startVideoCapturing]
-  /// and set `enablePersistentRecording` of [VideoCaptureOptions] to `true`.
+  /// To avoid cancelling any active recording when this method is called,
+  /// you must start the recording with [startVideoCapturing]
+  /// with `enablePersistentRecording` set to `true`.
   @override
   Future<void> setDescriptionWhileRecording(
     CameraDescription description,
@@ -950,7 +950,7 @@ class AndroidCameraCameraX extends CameraPlatform {
       cameraInfoForFilter: chosenCameraInfo,
     );
 
-    // unbind all use cases and rebind to new cameraSelector
+    // Unbind all use cases and rebind to new CameraSelector
     final List<UseCase> useCases = <UseCase>[preview!, videoCapture!];
     if (imageCapture != null &&
         await processCameraProvider!.isBound(imageCapture!)) {

packages/camera/camera_platform_interface/lib/src/platform_interface/camera_platform.dart

@@ -293,9 +293,9 @@ abstract class CameraPlatform extends PlatformInterface {
 
   /// Sets the active camera while recording.
   ///
-  /// On Android, calling this method will normally cancel any active recording.
-  /// To avoid this, start the recording with [startVideoCapturing]
-  /// and set `enablePersistentRecording` of [VideoCaptureOptions] to `true`.
+  /// On Android, you must start the recording with [startVideoCapturing]
+  /// with `enablePersistentRecording` set to `true`
+  /// to avoid cancelling any active recording.
   Future<void> setDescriptionWhileRecording(CameraDescription description) {
     throw UnimplementedError(
       'setDescriptionWhileRecording() is not implemented.',

packages/camera/camera_platform_interface/lib/src/types/video_capture_options.dart

@@ -49,8 +49,8 @@ class VideoCaptureOptions {
   /// A persistent recording will only be stopped by explicitly calling [CameraController.stopVideoRecording]
   /// and will ignore events that would normally cause recording to stop, such as lifecycle events.
   ///
-  /// **Note:** On Android, calling [CameraController.setDescription] will normally cancel any active recording.
-  /// To avoid this, set this parameter to `true`.
+  /// On Android, you must set this parameter to `true`
+  /// to avoid cancelling any active recording when calling [CameraController.setDescription].
   ///
   /// Defaults to `false`.
   final bool enablePersistentRecording;