Address PR review comments

- Rename enabledFor to enabledVariants for clarity
- Add documentation clarifying that global ignore settings
  have no relation to distribution settings
- Keep @experimental annotation for new APIs

Author: runningcode

plugin-build/src/main/kotlin/io/sentry/android/gradle/extensions/DistributionExtension.kt

@@ -8,7 +8,12 @@ import org.jetbrains.annotations.ApiStatus.Experimental
 @Experimental
 open class DistributionExtension @Inject constructor(objects: ObjectFactory) {
 
-  /** Set of Android build variants that should have build distribution enabled. */
-  val enabledFor: SetProperty<String> =
+  /**
+   * Set of Android build variants that should have distribution enabled.
+   *
+   * Note: The global ignore settings (ignoredVariants, ignoredBuildTypes, ignoredFlavors)
+   * have no relation to distribution and do not affect which variants are enabled here.
+   */
+  val enabledVariants: SetProperty<String> =
     objects.setProperty(String::class.java).convention(emptySet())
 }

plugin-build/src/test/kotlin/io/sentry/android/gradle/extensions/DistributionExtensionTest.kt

@@ -8,20 +8,20 @@ import org.junit.Test
 class DistributionExtensionTest {
 
   @Test
-  fun `enabledFor is empty by default`() {
+  fun `enabledVariants is empty by default`() {
     val project = ProjectBuilder.builder().build()
     val extension = project.objects.newInstance(DistributionExtension::class.java)
 
-    assertTrue(extension.enabledFor.get().isEmpty())
+    assertTrue(extension.enabledVariants.get().isEmpty())
   }
 
   @Test
-  fun `enabledFor can be configured with variant names`() {
+  fun `enabledVariants can be configured with variant names`() {
     val project = ProjectBuilder.builder().build()
     val extension = project.objects.newInstance(DistributionExtension::class.java)
 
-    extension.enabledFor.set(setOf("freeDebug", "paidRelease"))
+    extension.enabledVariants.set(setOf("freeDebug", "paidRelease"))
 
-    assertEquals(setOf("freeDebug", "paidRelease"), extension.enabledFor.get())
+    assertEquals(setOf("freeDebug", "paidRelease"), extension.enabledVariants.get())
   }
 }