diff --git a/plugins/package-managers/node/src/main/kotlin/Yarn.kt b/plugins/package-managers/node/src/main/kotlin/Yarn.kt
index 01476fb41f0d4..d154cd8560b19 100644
--- a/plugins/package-managers/node/src/main/kotlin/Yarn.kt
+++ b/plugins/package-managers/node/src/main/kotlin/Yarn.kt
@@ -105,6 +105,9 @@ class Yarn(
  * separated by newlines; for instance, if the operation is retried due to network problems. This function filters for
  * the object with the data based on the _type_ field. Result is *null* if no matching object is found or the input is
  * not valid JSON.
+ *
+ * Note: The mentioned network issue can be reproduced by setting the network timeout to be very short via the command
+ * line option '--network-timeout'.
  */
 internal fun parseYarnInfo(output: String): PackageJson? =
     runCatching {