From 83f0304cfcf6d673cdd9eedd4924ad92f7e46696 Mon Sep 17 00:00:00 2001
From: Kapunahele Wong <kapunahelewong@gmail.com>
Date: Tue, 18 Jun 2019 17:03:19 -0400
Subject: [PATCH] docs: clarify wording in Template Syntax (#31119)

PR Close #31119
---
 aio/content/guide/template-syntax.md | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/aio/content/guide/template-syntax.md b/aio/content/guide/template-syntax.md
index d42d9b1ce8..d12de2f50a 100644
--- a/aio/content/guide/template-syntax.md
+++ b/aio/content/guide/template-syntax.md
@@ -1626,6 +1626,14 @@ Here is an illustration of the `trackBy` effect.
   <img src="generated/images/guide/built-in-directives/ngfor-trackby.gif" alt="Animation of trackBy">
 </figure>
 
+
+<div class="alert is-helpful">
+
+Built-in directives use only public APIs; that is,
+they do not have special access to any private APIs that other directives can't access.
+
+</div>
+
 <hr/>
 
 {@a ngSwitch}
@@ -1753,7 +1761,9 @@ This example declares the `fax` variable as `ref-fax` instead of `#fax`.
 
 ## `@Input()` and `@Output()` properties
 
-`@Input()` and `@Output()` allow Angular to share data between the parent context and child directives. An `@Input()` property is writable while an `@Output()` property is observable.
+`@Input()` and `@Output()` allow Angular to share data between the parent context
+and child directives or components. An `@Input()` property is writable
+while an `@Output()` property is observable.
 
 Consider this example of a child/parent relationship: