Update Core's docs to be Swift first. (#9458)

Author: ryanwilson

FirebaseCore/Sources/Public/FirebaseCore/FIRApp.h

@@ -26,20 +26,21 @@ typedef void (^FIRAppVoidBoolCallback)(BOOL success) NS_SWIFT_NAME(FirebaseAppVo
 /**
  * The entry point of Firebase SDKs.
  *
- * Initialize and configure FIRApp using +[FIRApp configure]
+ * Initialize and configure `FirebaseApp` using `FirebaseApp.configure()`
  * or other customized ways as shown below.
  *
  * The logging system has two modes: default mode and debug mode. In default mode, only logs with
  * log level Notice, Warning and Error will be sent to device. In debug mode, all logs will be sent
  * to device. The log levels that Firebase uses are consistent with the ASL log levels.
  *
- * Enable debug mode by passing the -FIRDebugEnabled argument to the application. You can add this
- * argument in the application's Xcode scheme. When debug mode is enabled via -FIRDebugEnabled,
+ * Enable debug mode by passing the `-FIRDebugEnabled` argument to the application. You can add this
+ * argument in the application's Xcode scheme. When debug mode is enabled via `-FIRDebugEnabled`,
  * further executions of the application will also be in debug mode. In order to return to default
- * mode, you must explicitly disable the debug mode with the application argument -FIRDebugDisabled.
+ * mode, you must explicitly disable the debug mode with the application argument
+ * `-FIRDebugDisabled`.
  *
- * It is also possible to change the default logging level in code by calling setLoggerLevel: on
- * the FIRConfiguration interface.
+ * It is also possible to change the default logging level in code by calling
+ * `FirebaseConfiguration.shared.setLoggerLevel(_:)` with the desired level.
  */
 NS_SWIFT_NAME(FirebaseApp)
 @interface FIRApp : NSObject
@@ -75,31 +76,31 @@ NS_SWIFT_NAME(FirebaseApp)
 // clang-format on
 
 /**
- * Returns the default app, or nil if the default app does not exist.
+ * Returns the default app, or `nil` if the default app does not exist.
  */
 + (nullable FIRApp *)defaultApp NS_SWIFT_NAME(app());
 
 /**
- * Returns a previously created FIRApp instance with the given name, or nil if no such app exists.
- * This method is thread safe.
+ * Returns a previously created `FirebaseApp` instance with the given name, or `nil` if no such app
+ * exists. This method is thread safe.
  */
 + (nullable FIRApp *)appNamed:(NSString *)name NS_SWIFT_NAME(app(name:));
 
 /**
- * Returns the set of all extant FIRApp instances, or nil if there are no FIRApp instances. This
- * method is thread safe.
+ * Returns the set of all extant `FirebaseApp` instances, or `nil` if there are no `FirebaseApp`
+ * instances. This method is thread safe.
  */
 @property(class, readonly, nullable) NSDictionary<NSString *, FIRApp *> *allApps;
 
 /**
- * Cleans up the current FIRApp, freeing associated data and returning its name to the pool for
- * future use. This method is thread safe.
+ * Cleans up the current `FirebaseApp`, freeing associated data and returning its name to the pool
+ * for future use. This method is thread safe.
  */
 - (void)deleteApp:(FIRAppVoidBoolCallback)completion;
 
 /**
- * FIRApp instances should not be initialized directly. Call +[FIRApp configure],
- * +[FIRApp configureWithOptions:], or +[FIRApp configureWithNames:options:] directly.
+ * `FirebaseApp` instances should not be initialized directly. Call `FirebaseApp.configure()`,
+ * `FirebaseApp.configure(options:)`, or `FirebaseApp.configure(name:options:)` directly.
  */
 - (instancetype)init NS_UNAVAILABLE;
 
@@ -114,7 +115,7 @@ NS_SWIFT_NAME(FirebaseApp)
 @property(nonatomic, copy, readonly) FIROptions *options;
 
 /**
- * Gets or sets whether automatic data collection is enabled for all products. Defaults to `YES`
+ * Gets or sets whether automatic data collection is enabled for all products. Defaults to `true`
  * unless `FirebaseDataCollectionDefaultEnabled` is set to `NO` in your app's Info.plist. This value
  * is persisted across runs of the app so that it can be set once when users have consented to
  * collection.

FirebaseCore/Sources/Public/FirebaseCore/FIRConfiguration.h

@@ -31,9 +31,9 @@ NS_SWIFT_NAME(FirebaseConfiguration)
 
 /**
  * Sets the logging level for internal Firebase logging. Firebase will only log messages
- * that are logged at or below loggerLevel. The messages are logged both to the Xcode
+ * that are logged at or below `loggerLevel`. The messages are logged both to the Xcode
  * console and to the device's log. Note that if an app is running from AppStore, it will
- * never log above FIRLoggerLevelNotice even if loggerLevel is set to a higher (more verbose)
+ * never log above `.notice` even if `loggerLevel` is set to a higher (more verbose)
  * setting.
  *
  * @param loggerLevel The maximum logging level. The default level is set to FIRLoggerLevelNotice.

FirebaseCore/Sources/Public/FirebaseCore/FIROptions.h

@@ -38,7 +38,7 @@ NS_SWIFT_NAME(FirebaseOptions)
 @property(nonatomic, copy, nullable) NSString *APIKey NS_SWIFT_NAME(apiKey);
 
 /**
- * The bundle ID for the application. Defaults to `[[NSBundle mainBundle] bundleID]` when not set
+ * The bundle ID for the application. Defaults to `Bundle.mainBundle.bundleID()` when not set
  * manually or in a plist.
  */
 @property(nonatomic, copy) NSString *bundleID;
@@ -107,17 +107,17 @@ NS_SWIFT_NAME(FirebaseOptions)
  *       let options = FirebaseOptions(contentsOfFile: path)
  *   }
  * ```
- * Note that it is not possible to customize FirebaseOptions for Firebase Analytics which expects a
- * static file named `GoogleServices-Info.plist` -
+ * Note that it is not possible to customize `FirebaseOptions` for Firebase Analytics which expects
+ * a static file named `GoogleServices-Info.plist` -
  * https://github.com/firebase/firebase-ios-sdk/issues/230.
- * Returns nil if the plist file does not exist or is invalid.
+ * Returns `nil` if the plist file does not exist or is invalid.
  */
 - (nullable instancetype)initWithContentsOfFile:(NSString *)plistPath NS_DESIGNATED_INITIALIZER;
 
 /**
- * Initializes a customized instance of FirebaseOptions with required fields. Use the mutable
+ * Initializes a customized instance of `FirebaseOptions` with required fields. Use the mutable
  * properties to modify fields for configuring specific services. Note that it is not possible to
- * customize FirebaseOptions for Firebase Analytics which expects a static file named
+ * customize `FirebaseOptions` for Firebase Analytics which expects a static file named
  * `GoogleServices-Info.plist` - https://github.com/firebase/firebase-ios-sdk/issues/230.
  */
 - (instancetype)initWithGoogleAppID:(NSString *)googleAppID

SwiftDashboard.md

@@ -17,7 +17,7 @@ tasks for additional Swift improvements.
 | **SwiftUI Lifecycle** |  ❌    | n/a    | n/a   | ❌     | n/a    |n/a     | n/a     | ❌    | n/a    | n/a     | n/a    | n/a    | ❌     | n/a    | ❌     | n/a   |n/a  |
 | **SwiftUI Interop**   |   ✔    | n/a    | ❌    | ❌     | n/a     |❌      | ❌      | n/a    | ✔     | n/a     | ✔      | n/a   | n/a     | n/a    | ❌     | n/a   |n/a  |
 | **Property Wrappers** |  ❌    | ❌     |❌     | ❌     | ❌     | ❌     | ❌      | ❌     | 6     | ❌     | ❌     | ❌    | ❌     | ❌    | ❌     | ❌   |❌    |
-| **Swift Doc Scrub**   |  ❌    | ❌     |❌     | ❌     | ❌     | ✔     | ❌      | ❌     |  ❌   | ❌     | ❌     | ❌    | ❌     | ❌    | ❌     | ❌   |❌    |
+| **Swift Doc Scrub**   |  ❌    | ❌     |❌     | ❌     | ✔      | ✔     | ❌      | ❌     |  ❌   | ❌     | ❌     | ❌    | ❌     | ❌    | ❌     | ❌   |❌    |
 
 ### Other Projects
 - Tooling to surface full list of automatically generated Swift API from Objective C and validate.