Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(1451)

Unified Diff: pkg/polymer_expressions/README.md

Issue 23453034: Added library-level comments for polymer and polymer_expressions (Closed) Base URL: https://dart.googlecode.com/svn/branches/bleeding_edge/dart
Patch Set: merge with master Created 7 years, 3 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « pkg/polymer/lib/polymer.dart ('k') | pkg/polymer_expressions/lib/polymer_expressions.dart » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: pkg/polymer_expressions/README.md
diff --git a/pkg/polymer_expressions/README.md b/pkg/polymer_expressions/README.md
index 5a7e9b29cbd40e4c163ca5027f93096466c01996..9cc3da4887f27415a1419f97a0e70cfcc093d046 100644
--- a/pkg/polymer_expressions/README.md
+++ b/pkg/polymer_expressions/README.md
@@ -1,8 +1,25 @@
polymer_expressions
===================
-Polymer Expressions are an expressive syntax that can be used in templates in
-Dart. Polymer Expressions allow you to write complex binding expressions, with
+
+Polymer expressions are an expressive syntax that can be used in HTML templates
+with Dart.
+
+Templates are one feature of Polymer.dart, which is a set of comprehensive UI
+and utility components for building web applications.
+This package is automatically included with the
+[Polymer](https://pub.dartlang.org/packages/polymer) package
+because Polymer expressions are the default expression syntax
+in Polymer Dart apps.
+The [Polymer.dart homepage][home_page]
+contains a list of features, project status,
+installation instructions, tips for upgrading from Web UI,
+and links to other documentation.
+
+
+## Overview
+
+Polymer expressions allow you to write complex binding expressions, with
property access, function invocation, list/map indexing, and two-way filtering
like:
@@ -10,12 +27,10 @@ like:
{{ person.title + " " + person.getFullName() | upppercase }}
```
-## Overview
-
### Model-Driven Views (MDV)
-[MDV][mdv] allows you to define templates directly in HTML that are rendered by the
-browser into the DOM. Templates are bound to a data model, and changes to the
-data are automatically reflected in the DOM, and changes in HTML inputs are
+[MDV][mdv] allows you to define templates directly in HTML that are rendered by
+the browser into the DOM. Templates are bound to a data model, and changes to
+the data are automatically reflected in the DOM, and changes in HTML inputs are
assigned back into the model. The template and model are bound together via
binding expressions that are evaluated against the model. These binding
expressions are placed in double-curly-braces, or "mustaches".
« no previous file with comments | « pkg/polymer/lib/polymer.dart ('k') | pkg/polymer_expressions/lib/polymer_expressions.dart » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698