update deprecation message for common (#5389)

Author: VinayGuthal

appcheck/firebase-appcheck/CHANGELOG.md

@@ -2,13 +2,13 @@
 * [changed] Added Kotlin extensions (KTX) APIs from `com.google.firebase:firebase-appcheck-ktx`
   to `com.google.firebase:firebase-appcheck` under the `com.google.firebase.appcheck` package.
   For details, see the
-  [FAQ about this initiative](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+  [FAQ about this initiative](https://firebase.google.com/docs/android/kotlin-migration)
 
 * [deprecated] All the APIs from `com.google.firebase:firebase-appcheck-ktx` have been added to
   `com.google.firebase:firebase-appcheck` under the `com.google.firebase.appcheck` package,
   and all the Kotlin extensions (KTX) APIs in `com.google.firebase:firebase-appcheck-ktx` are
   now deprecated. As early as April 2024, we'll no longer release KTX modules. For details, see the
-  [FAQ about this initiative](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+  [FAQ about this initiative](https://firebase.google.com/docs/android/kotlin-migration)
 
 
 

appcheck/firebase-appcheck/src/main/java/com/google/firebase/appcheck/ktx/FirebaseAppCheck.kt

@@ -28,7 +28,7 @@ import com.google.firebase.ktx.app
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-appcheck-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.appcheck.Firebase.appCheck` from the main module instead.",
@@ -46,7 +46,7 @@ val Firebase.appCheck: FirebaseAppCheck
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-appcheck-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.appcheck.Firebase.appCheck(app)` from the main module instead.",
@@ -65,7 +65,7 @@ fun Firebase.appCheck(app: FirebaseApp) = FirebaseAppCheck.getInstance(app)
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-appcheck-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.appcheck.AppCheckToken.component1` from the main module instead.",
@@ -81,7 +81,7 @@ operator fun AppCheckToken.component1() = token
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-appcheck-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.appcheck.AppCheckToken.component2` from the main module instead.",
@@ -95,7 +95,7 @@ operator fun AppCheckToken.component2() = expireTimeMillis
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-appcheck-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.appcheck.FirebaseAppCheckKtxRegistrar` from the main module instead.",

firebase-appdistribution-api/CHANGELOG.md

@@ -4,7 +4,7 @@
   to `com.google.firebase:firebase-appdistribution-api` under the 
   `com.google.firebase.appdistribution` package.
   For details, see the
-  [FAQ about this initiative](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+  [FAQ about this initiative](https://firebase.google.com/docs/android/kotlin-migration)
 
 * [deprecated] All the APIs from `com.google.firebase:firebase-appdistribution-api-ktx` have been 
   added to
@@ -13,7 +13,7 @@
   and all the Kotlin extensions (KTX) APIs in `com.google.firebase:firebase-appdistribution-api-ktx`
   are now deprecated. As early as April 2024, we'll no longer release KTX modules. For details, 
   see the
-  [FAQ about this initiative](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+  [FAQ about this initiative](https://firebase.google.com/docs/android/kotlin-migration)
 
 # 16.0.0-beta09
 * [feature] Improved development mode to allow all API calls to be made without having to sign in.

firebase-appdistribution-api/src/main/java/com/google/firebase/appdistribution/ktx/FirebaseAppDistribution.kt

@@ -29,7 +29,7 @@ import com.google.firebase.ktx.Firebase
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase:firebase-appdistribution-api-ktx` are now deprecated. As early as April
  * 2024, we'll no longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.Firebase.appDistribution` from the main module instead.",
@@ -50,7 +50,7 @@ val Firebase.appDistribution: FirebaseAppDistribution
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase:firebase-appdistribution-api-ktx` are now deprecated. As early as April
  * 2024, we'll no longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.appdistribution.AppDistributionRelease.component1()` from the main module instead.",
@@ -69,7 +69,7 @@ operator fun AppDistributionRelease.component1() = binaryType
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase:firebase-appdistribution-api-ktx` are now deprecated. As early as April
  * 2024, we'll no longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.appdistribution.AppDistributionRelease.component2()` from the main module instead.",
@@ -88,7 +88,7 @@ operator fun AppDistributionRelease.component2() = displayVersion
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase:firebase-appdistribution-api-ktx` are now deprecated. As early as April
  * 2024, we'll no longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.appdistribution.AppDistributionRelease.component3()` from the main module instead.",
@@ -107,7 +107,7 @@ operator fun AppDistributionRelease.component3() = versionCode
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase:firebase-appdistribution-api-ktx` are now deprecated. As early as April
  * 2024, we'll no longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.appdistribution.AppDistributionRelease.component4()` from the main module instead.",
@@ -126,7 +126,7 @@ operator fun AppDistributionRelease.component4() = releaseNotes
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase:firebase-appdistribution-api-ktx` are now deprecated. As early as April
  * 2024, we'll no longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.appdistribution.UpdateProgress.component1()` from the main module instead.",
@@ -145,7 +145,7 @@ operator fun UpdateProgress.component1() = apkBytesDownloaded
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase:firebase-appdistribution-api-ktx` are now deprecated. As early as April
  * 2024, we'll no longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.appdistribution.UpdateProgress.component2()` from the main module instead.",
@@ -164,7 +164,7 @@ operator fun UpdateProgress.component2() = apkFileTotalBytes
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase:firebase-appdistribution-api-ktx` are now deprecated. As early as April
  * 2024, we'll no longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.appdistribution.UpdateProgress.component3()` from the main module instead.",
@@ -181,7 +181,7 @@ operator fun UpdateProgress.component3() = updateStatus
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase:firebase-appdistribution-api-ktx` are now deprecated. As early as April
  * 2024, we'll no longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.appdistribution.FirebaseAppDistributionKtxRegistrar` from the main module instead.",

firebase-common/CHANGELOG.md

@@ -2,15 +2,15 @@
 * [changed] Added Kotlin extensions (KTX) APIs from `com.google.firebase:firebase-common-ktx` 
 to `com.google.firebase:firebase-common` under the `com.google.firebase` package. 
 For details, see the
-[FAQ about this initiative](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+[FAQ about this initiative](https://firebase.google.com/docs/android/kotlin-migration)
 
 ## Kotlin
 * [deprecated] All the APIs from `com.google.firebase:firebase-common-ktx` have been added to
 `com.google.firebase:firebase-common` under the `com.google.firebase package`, and all the 
 Kotlin extensions (KTX) APIs in `com.google.firebase:firebase-common-ktx` are now deprecated.
 As early as April 2024, we'll no longer release KTX modules. For details, see the 
 FAQ about this initiative.
-[FAQ about this initiative](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+[FAQ about this initiative](https://firebase.google.com/docs/android/kotlin-migration)
 
 # 20.3.3
 * [fixed] Addressed issue with C++ being absent in user agent.

firebase-common/src/main/java/com/google/firebase/ktx/Firebase.kt

@@ -30,19 +30,17 @@ import kotlinx.coroutines.CoroutineDispatcher
 import kotlinx.coroutines.asCoroutineDispatcher
 
 /**
- * Single access point to all firebase SDKs from Kotlin.
+ * All fields in this object are deprecated; Use `com.google.firebase.Firebase` instead.
+ *
+ * Single access point to all firebase SDKs from Kotlin. Acts as a target for extension methods
+ * provided by sdks.
  *
- * <p>Acts as a target for extension methods provided by sdks.
  * @deprecated **Deprecation Notice:** The Kotlin extensions (KTX) APIs have been added to their
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-common-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
-@Deprecated(
-  "Use `com.google.firebase.Firebase` from the main module instead.",
-  ReplaceWith(expression = "Firebase", imports = ["com.google.firebase.Firebase"])
-)
 object Firebase
 
 /**
@@ -51,7 +49,7 @@ object Firebase
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-common-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules).
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration).
  */
 @Deprecated(
   "Use `com.google.firebase.Firebase.app` from the main module instead.",
@@ -69,7 +67,7 @@ val Firebase.app: FirebaseApp
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-common-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules).
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration).
  */
 @Deprecated(
   "Use `com.google.firebase.Firebase.app(name)` from the main module instead.",
@@ -86,7 +84,7 @@ fun Firebase.app(name: String): FirebaseApp = FirebaseApp.getInstance(name)
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-common-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.Firebase.initialize(context)` from the main module instead.",
@@ -103,7 +101,7 @@ fun Firebase.initialize(context: Context): FirebaseApp? = FirebaseApp.initialize
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-common-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.Firebase.initialize(context, options)` from the main module instead.",
@@ -121,7 +119,7 @@ fun Firebase.initialize(context: Context, options: FirebaseOptions): FirebaseApp
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-common-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.Firebase.initialize(context, options, name)` from the main module instead.",
@@ -139,7 +137,7 @@ fun Firebase.initialize(context: Context, options: FirebaseOptions, name: String
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-common-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
- * [FAQ about this initiative.](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+ * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
   "Use `com.google.firebase.Firebase.options` from the main module instead.",

firebase-config/CHANGELOG.md

@@ -2,13 +2,13 @@
 * [changed] Added Kotlin extensions (KTX) APIs from `com.google.firebase:firebase-config-ktx`
   to `com.google.firebase:firebase-config` under the `com.google.firebase.remoteconfig` package.
   For details, see the
-  [FAQ about this initiative](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+  [FAQ about this initiative](https://firebase.google.com/docs/android/kotlin-migration)
 
 * [deprecated] All the APIs from `com.google.firebase:firebase-config-ktx` have been added to
   `com.google.firebase:firebase-config` under the `com.google.firebase.remoteconfig` package,
   and all the Kotlin extensions (KTX) APIs in `com.google.firebase:firebase-config-ktx` are
   now deprecated. As early as April 2024, we'll no longer release KTX modules. For details, see the
-  [FAQ about this initiative](https://firebase.google.com/docs/android/ktx-apis-to-main-modules)
+  [FAQ about this initiative](https://firebase.google.com/docs/android/kotlin-migration)
 
 
 # 21.4.1