From 989f6f20565aa9be169871933e72e3edd9dd3521 Mon Sep 17 00:00:00 2001 From: Brian Ford Date: Mon, 3 Mar 2014 12:43:41 -0800 Subject: docs(guide/databinding): reword for clarity --- docs/content/guide/databinding.ngdoc | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) (limited to 'docs/content') diff --git a/docs/content/guide/databinding.ngdoc b/docs/content/guide/databinding.ngdoc index e5b4f754..c7ce3358 100644 --- a/docs/content/guide/databinding.ngdoc +++ b/docs/content/guide/databinding.ngdoc @@ -2,7 +2,7 @@ @name Data Binding @description -Data-binding in Angular web apps is the automatic synchronization of data between the model and view +Data-binding in Angular apps is the automatic synchronization of data between the model and view components. The way that Angular implements data-binding lets you treat the model as the single-source-of-truth in your application. The view is a projection of the model at all times. When the model changes, the view reflects the change, and vice versa. @@ -11,7 +11,7 @@ When the model changes, the view reflects the change, and vice versa. Most templating systems bind data in only one direction: they merge template and model components -together into a view, as illustrated in the diagram. After the merge occurs, changes to the model +together into a view. After the merge occurs, changes to the model or related sections of the view are NOT automatically reflected in the view. Worse, any changes that the user makes to the view are not reflected in the model. This means that the developer has to write code that constantly syncs the view with the model and the model with the view. @@ -19,12 +19,11 @@ to write code that constantly syncs the view with the model and the model with t ## Data Binding in Angular Templates -The way Angular templates works is different, as illustrated in the diagram. They are different -because first the template (which is the uncompiled HTML along with any additional markup or -directives) is compiled on the browser, and second, the compilation step produces a live view. We -say live because any changes to the view are immediately reflected in the model, and any changes in -the model are propagated to the view. This makes the model always the single-source-of-truth for -the application state, greatly simplifying the programming model for the developer. You can think of +Angular templates work differently. First the template (which is the uncompiled HTML along with +any additional markup or directives) is compiled on the browser. The compilation step produces a +live view. Any changes to the view are immediately reflected in the model, and any changes in +the model are propagated to the view. The model is the single-source-of-truth for the application +state, greatly simplifying the programming model for the developer. You can think of the view as simply an instant projection of your model. Because the view is just a projection of the model, the controller is completely separated from the -- cgit v1.2.3