diff --git a/tools/broccoli/broccoli.d.ts b/tools/broccoli/broccoli.d.ts
index 7fb67149d2..3f5aac746b 100644
--- a/tools/broccoli/broccoli.d.ts
+++ b/tools/broccoli/broccoli.d.ts
@@ -17,7 +17,8 @@ interface BroccoliTree {
    * For plugins that take only one input tree, it might be more convenient to use the `inputPath`
    *property instead.
    *
-   * This property is set just before the first rebuild and doesn't change afterwards.
+   * This property is set just before the first rebuild and doesn't change afterwards, unless
+   * plugins themselves change it.
    *
    * If the inputPath is outside of broccoli's temp directory, then it's lifetime is not managed by
    *the builder.
@@ -31,7 +32,8 @@ interface BroccoliTree {
   /**
    * Contains the fs paths for the output trees.
    *
-   * This property is set just before the first rebuild and doesn't change afterwards.
+   * This property is set just before the first rebuild and doesn't change afterwards, unless the
+   * plugins themselves change it.
    *
    * The underlying directory is also created by the builder just before the first rebuild.
    * This directory is destroyed and recreated upon each rebuild.