"Reverting 30388"

samples/third_party/todomvc/README.md

Index: samples/third_party/todomvc/README.md
diff --git a/samples/third_party/todomvc/README.md b/samples/third_party/todomvc/README.md
index bb92d8703d4727a6957568968f5943de4a4c0110..1422ab4623ea9bb83123ddd9c67fe8a31bc5225c 100644
--- a/samples/third_party/todomvc/README.md
+++ b/samples/third_party/todomvc/README.md
@@ -1,20 +1,38 @@
-TodoMVC sample application written with the
-[Polymer.dart package][polymer-dart], which includes
-custom elements and data binding.
+# Polymer TodoMVC Example
 
-To run this code with Dartium, launch `web/index.html`.
+> Build structured, encapsulated, client-side web apps with Dart and web components.
 
-To run this code with Chrome/Firefox/etc, run `build.dart` first,
-and then right-click on `out/web/index.html` and select 'Run as JavaScript'.
+> _[Polymer.dart](https://www.dartlang.org/polymer-dart/)_
 
-Generated code will be created under "out/web/". Any time you edit and save a 
-source file, the necessary files will be regenerated automatically. Look at
-`build.dart` to see how this works.
+> Polymer is a new type of library for the web, built on top of Web Components, and designed to leverage the evolving web platform on modern browsers.
 
-View the [source][source] for this example.
+> _[Polymer - www.polymer-project.org](http://www.polymer-project.org/)_
 
-Please report any [bugs or feature requests][bugs].
+## Learning Polymer
 
-[polymer-dart]: http://www.dartlang.org/polymer-dart/
-[source]: https://code.google.com/p/dart/source/browse/branches/bleeding_edge/dart/samples/third_party/todomvc/
-[bugs]: http://dartbug.com/new
+The [Polymer.dart website](https://www.dartlang.org/polymer-dart/) is a great resource for getting started.
+
+Get help from Polymer devs and users:
+
+* Join the high-traffic [web-ui](https://groups.google.com/a/dartlang.org/forum/#!forum/web-ui) Google group.
+* As questions on [Stack Overflow](http://stackoverflow.com/tags/dart-polymer)
+
+## Implementation
+
+The Polymer implementation of TodoMVC has a few key differences with other implementations:
+
+* Since [Web Components](https://dvcs.w3.org/hg/webcomponents/raw-file/tip/explainer/index.html) allow you to create new types of DOM elements, the DOM tree is very different from other implementations.
+* The template, styling, and behavior are fully encapsulated in each custom element. Instead of having an overall stylesheet (`base.css` or `app.css`), each element that needs styling has its own stylesheet.
+* Non-visual elements such as the router and the model are also implemented as custom elements and appear in the DOM. Implementing them as custom elements instead of plain objects allows you to take advantage of Polymer data binding and event handling throughout the app.
+
+## Running this sample
+
+To run in Dartium (Chrome with Dart VM):
+
+1. Right click on web/index.html and choose "Run in Dartium"
+
+To run in other browsers (such as Firefox, Internet Explorer, Safari, Chrome):
+
+1. Right click on pubspec.yaml and choose "Pub Build"
+2. After build finishes, expand the "build" directory
+3. Right click on index.html and choose "Run as JavaScript"