diff --git a/site/content/docs/02-template-syntax.md b/site/content/docs/02-template-syntax.md
index 917673a7b0..9e509aa735 100644
--- a/site/content/docs/02-template-syntax.md
+++ b/site/content/docs/02-template-syntax.md
@@ -553,6 +553,27 @@ To get a reference to a DOM node, use `bind:this`.
```
+Note that binding a property of a parent component to a child component's DOM node will throw a warning unless the property is assigned a default value:
+
+```html
+
+
+
+
+
+...
+
+
+
+
+
+```
+
+Assign a non-`undefined` value in either component to suppress the warning.
### Component bindings