diff --git a/src/rp2040/pico_platform_link/BUILD.bazel b/src/rp2040/pico_platform_link/BUILD.bazel
index 147cba5e..0a355624 100644
--- a/src/rp2040/pico_platform_link/BUILD.bazel
+++ b/src/rp2040/pico_platform_link/BUILD.bazel
@@ -33,15 +33,6 @@ use_linker_script_file(
     script = "memmap_no_flash.ld",
 )
 
-# It's possible to set linker scripts globally or on a per-binary basis.
-#
-# Setting globally:
-#   * Set --@pico-sdk//bazel/config:PICO_DEFAULT_LINKER_SCRIPT to point to your
-#     desired linker script.
-#
-# Setting per-binary:
-#   * Set --@pico-sdk//bazel/config:PICO_DEFAULT_LINKER_SCRIPT=@pico-sdk//bazel:empty_cc_lib
-#   * Manually add your desired linker script to each cc_binary.
 cc_library(
     name = "default_linker_script",
     target_compatible_with = ["//bazel/constraint:rp2040"],
diff --git a/src/rp2350/pico_platform_link/BUILD.bazel b/src/rp2350/pico_platform_link/BUILD.bazel
index 355002d0..d3aae916 100644
--- a/src/rp2350/pico_platform_link/BUILD.bazel
+++ b/src/rp2350/pico_platform_link/BUILD.bazel
@@ -32,15 +32,6 @@ use_linker_script_file(
     script = "memmap_no_flash.ld",
 )
 
-# It's possible to set linker scripts globally or on a per-binary basis.
-#
-# Setting globally:
-#   * Set --@pico-sdk//bazel/config:PICO_DEFAULT_LINKER_SCRIPT to point to your
-#     desired linker script.
-#
-# Setting per-binary:
-#   * Set --@pico-sdk//bazel/config:PICO_DEFAULT_LINKER_SCRIPT=@pico-sdk//bazel:empty_cc_lib
-#   * Manually add your desired linker script to each cc_binary.
 cc_library(
     name = "default_linker_script",
     target_compatible_with = ["//bazel/constraint:rp2350"],
diff --git a/src/rp2_common/pico_standard_link/BUILD.bazel b/src/rp2_common/pico_standard_link/BUILD.bazel
index 6c84336b..924358d5 100644
--- a/src/rp2_common/pico_standard_link/BUILD.bazel
+++ b/src/rp2_common/pico_standard_link/BUILD.bazel
@@ -18,6 +18,15 @@ generated_pico_flash_region(
     }),
 )
 
+# It's possible to set linker scripts globally or on a per-binary basis.
+#
+# Setting globally:
+#   * Set --@pico-sdk//bazel/config:PICO_DEFAULT_LINKER_SCRIPT to point to your
+#     desired linker script (eg @pico-sdk//src/pico_standard_link:no_flash_linker_script)
+#
+# Setting per-binary:
+#   * Set --@pico-sdk//bazel/config:PICO_DEFAULT_LINKER_SCRIPT=@pico-sdk//bazel:empty_cc_lib
+#   * Manually add your desired linker script to each cc_binary.
 alias(
     name = "default_linker_script",
     actual = select({