diff --git a/packages/compiler/src/compiler/codegen.ts b/packages/compiler/src/compiler/codegen.ts
index a5311c8..82537fc 100644
--- a/packages/compiler/src/compiler/codegen.ts
+++ b/packages/compiler/src/compiler/codegen.ts
@@ -122,6 +122,10 @@ export function expand(tree: Items, ctx: ExpansionContext): Items {
     const walk = (tree: Items): Items => expand(tree, ctx);
     const maybeWalk = (tree?: Items) : Items | undefined => (tree === void 0) ? tree : walk(tree);
 
+    // Unfortunately, because of the incredibly naive repeated
+    // traversal of the syntax tree we're doing, the order of the
+    // following transformations matters.
+
     xf(ctx.parser.duringStatement, (s, t) => {
         // TODO: untyped template
         const sa = compilePattern(s.pattern);