Adjust camera documentation

Author: danielsaidi

Sources/SwiftUIKit/Cameras/DocumentCamera.swift

@@ -10,24 +10,22 @@
 import SwiftUI
 import VisionKit
 
-/**
- This view can be used to open a camera that can scan one or
- multiple pages in a physical document.
-
- You create a document camera by providing two action blocks:
- 
- ```swift
- let camera = DocumentCamera(
-    cancelAction: { print("User did cancel") }  // Optional
-    resultAction: { result in ... }             // Mandatory
- }
- ```
-
- You can then present this camera with a sheet, a modal, etc.
-
- The camera uses a `VNDocumentCameraViewController` and will
- return a `VNDocumentCameraScan` with all document pages.
- */
+/// This view can be used to open a camera that can scan one
+/// or multiple pages in a physical document.
+///
+/// You can create a document camera by defining two actions:
+///
+/// ```swift
+/// let camera = DocumentCamera(
+///     cancelAction: { print("User did cancel") }  // Optional
+///     resultAction: { result in ... }             // Mandatory
+/// }
+/// ```
+///
+/// You can then present the camera with a sheet, modal, etc.
+///
+/// This camera uses a `VNDocumentCameraViewController` that
+/// will return a `VNDocumentCameraScan` with all scan pages.
 public struct DocumentCamera: UIViewControllerRepresentable {
 
     /// Create a document camera.

Sources/SwiftUIKit/Cameras/PhotoCamera.swift

@@ -10,23 +10,21 @@
 import Photos
 import SwiftUI
 
-/**
- This view can be used to open a camera that can take photos.
-
- You create a camera instance by providing two action blocks:
- 
- ```swift
- let picker = Camera(
-    cancelAction: { print("User did cancel") }  // Optional
-    finishAction: { result in ... })            // Mandatory
- }
- ```
-
- You can then present this camera with a sheet, a modal, etc.
- 
- This camera returns a result that contains the picked image,
- which you then can use in any way you want.
- */
+/// This view can be used to open a regular photo camera.
+///
+/// You can create a camera instance by defining two actions:
+///
+/// ```swift
+/// let picker = PhotoCamera(
+///     cancelAction: { print("User did cancel") }  // Optional
+///     finishAction: { result in ... })            // Mandatory
+/// }
+/// ```
+///
+/// You can then present the camera with a sheet, modal, etc.
+///
+/// The camera returns a result with the picked image, which
+/// you can then use in any way you want.
 public struct PhotoCamera: View {
 
     /// Create a photo camera.

Sources/SwiftUIKit/Pickers/ImagePicker.swift

@@ -11,28 +11,25 @@ import Photos
 import SwiftUI
 import UIKit
 
-/**
- This picker can be used to pick photos from Photos, using a
- camera to take a photo, etc.
- 
- The view wraps a `UIImagePickerController` and makes itself
- the delegate.
- 
- You can create a picker instance by providing a source type,
- as well as action blocks that are triggered when picking or
- cancelling the picker operation:
- 
- ```swift
- let picker = ImagePicker(
-    sourceType: .camera,
-    cancelAction: { print("User did cancel") }  // Optional
-    resultAction: { result in ... })            // Mandatory
- }
- ```
- 
- The picker result contains the picked image, which you then
- can use in any way you want.
- */
+/// This picker can be used to pick photos from Photos, pick
+/// a photo with the camera, etc.
+///
+/// The view wraps a `UIImagePickerController` and registers
+/// itself as the picker delegate.
+///
+/// You can create an image picker instance by providing the
+/// picker source type, plus actions that are triggered when
+/// picking or cancelling the picker operation:
+///
+/// ```swift
+/// let picker = ImagePicker(
+///     sourceType: .camera,
+///     cancelAction: { print("User did cancel") }  // Optional
+///     resultAction: { result in ... })            // Mandatory
+/// }
+/// ```
+/// The picker returns a result with the picked image, which
+/// you can then use in any way you want.
 public struct ImagePicker: UIViewControllerRepresentable {
 
     /// Create an image picker.