diff --git a/.github/workflows/common.yml b/.github/workflows/common.yml
index 2bd85247a7d..60ee27117af 100644
--- a/.github/workflows/common.yml
+++ b/.github/workflows/common.yml
@@ -12,6 +12,12 @@ on:
         required: true
 
       # The platforms to build on. Defaults to all.
+      # To target specific platforms, pass a comma or space separated string of
+      # platforms.
+      #
+      # Examples:
+      # - build/test only for macOS: `macOS`
+      # - build/test only for macOS and tvOS: `macOS, tvOS`
       platforms:
         type: string
         required: false
@@ -23,6 +29,9 @@ on:
       #
       # Platform options: [iOS, tvOS, macOS, watchOS, catalyst, visionOS]
       #
+      # Note: Build-only platforms must be represented in the `platforms` input
+      # (which defaults to all platforms) in order to take effect.
+      #
       # Examples:
       # - build only for macOS: `macOS`
       # - build only for macOS and tvOS: `macOS, tvOS`