Added library-level comments for polymer and polymer_expressions

pkg/polymer_expressions/README.md

Index: pkg/polymer_expressions/README.md
diff --git a/pkg/polymer_expressions/README.md b/pkg/polymer_expressions/README.md
index 5a7e9b29cbd40e4c163ca5027f93096466c01996..f01b17ce2e6fe10878f70beee57363a2b4393e00 100644
--- a/pkg/polymer_expressions/README.md
+++ b/pkg/polymer_expressions/README.md
@@ -1,8 +1,24 @@
 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 templates in

[justinfagnani, 2013/09/10 00:49:20]

I think we should say what kind of templates. "HTML templates", "MDV templates"?
I'm not sure what the official terminology is at this moment.

[Jennifer Messerly, 2013/09/10 02:29:07]

just wanted to remind: we shouldn't use "mdv" anywhere... the term is dead. Long
live MDV :)
https://github.com/Polymer/TemplateBinding

here is the official word:
http://www.polymer-project.org/docs/polymer/databinding.html

Personally, I think "templates" is plenty specific. It *is* the HTML <template>
element, after all :)

[mem, 2013/09/11 20:53:30]

Done.

+Dart.
+
+Templates are one feature of Polymer.dart—a set of comprehensive UI

[justinfagnani, 2013/09/10 00:49:20]

spaces around the dash? not sure how that should be

[Jennifer Messerly, 2013/09/10 02:29:07]

fwiw, — is not very Markdow-ish, since the intent of Markdown is to be
readable without a tool.

Perhaps the unicode mdash char (U+2014), or just "--" ?

[mem, 2013/09/11 20:53:30]

Done.

+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 often used in polymer Dart apps.

[justinfagnani, 2013/09/10 00:49:20]

often used -> the default expression syntax

[justinfagnani, 2013/09/10 00:49:20]

should "polymer" be capitalized?

[mem, 2013/09/11 20:53:30]

Done.

+The [Polymer.dart home page][home_page]
+contains a list of features, project status,
+installation instructions, instructions 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,8 +26,6 @@ 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