diff --git a/public/docs/_examples/upgrade-adapter/ts/app/upgrade-io/hero-detail.component.ts b/public/docs/_examples/upgrade-adapter/ts/app/upgrade-io/hero-detail.component.ts
index 3295fe9382..175c1ed317 100644
--- a/public/docs/_examples/upgrade-adapter/ts/app/upgrade-io/hero-detail.component.ts
+++ b/public/docs/_examples/upgrade-adapter/ts/app/upgrade-io/hero-detail.component.ts
@@ -1,7 +1,7 @@
 // #docregion
 export const heroDetail = {
   bindings: {
-    hero: '=',
+    hero: '<',
     deleted: '&'
   },
   template: `
diff --git a/public/docs/ts/latest/guide/upgrade.jade b/public/docs/ts/latest/guide/upgrade.jade
index d29d1caa5f..4d906213c7 100644
--- a/public/docs/ts/latest/guide/upgrade.jade
+++ b/public/docs/ts/latest/guide/upgrade.jade
@@ -592,6 +592,14 @@ table
     td
       :marked
         `<my-component (myOutput)="action()">`
+  tr
+    th One-way binding
+    td
+      :marked
+        `myValue: '<myValue'`
+    td
+      :marked
+        `<my-component [myValue]="anExpression">`
   tr
     th Two-way binding
     td
@@ -599,8 +607,9 @@ table
         `myValue: '=myValue'`
     td
       :marked
-        As input: `<my-component [myValue]="anExpression">` or
-        as two-way binding: `<my-component [(myValue)]="anExpression"`
+        As a two-way binding: `<my-component [(myValue)]="anExpression">`.
+        Since most Angular 1 two-way bindings actually only need a one-way binding
+        in practice, `<my-component [myValue]="anExpression">` is often enough.
 
 :marked
   As an example, say we have a hero detail Angular 1 component directive