diff --git a/README.md b/README.md index f34ac719ce..140208a2c6 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,17 @@ Polymer lets you build encapsulated, re-usable elements that work just like HTML elements, to use in building web applications. +Polymer is a library built on top of Web Component, that makes it easier to build your very own custom HTML elements, which can be reused for any project. It makes building complex web applications easier and more efficient. Imagine you have a specific navigation bar or a hamburger menu that you like to create and use in all of your projects. Instead of building that navigation bar or menu for every project, you can utilize Polymer to easily create that element one time and then reuse it throughout your project or any project of your choosing. + +Polymer provides a declarative syntax (defining what needs to be done and letting the computer figure out how to do it), to easily create your own custom elements. It allows one to easily develop the structure of the element with HTML, style it with CSS, and add interactions with the element utilizing JavaScript. It also provides two-way data-binding meaning: + +1. When properties in the model gets updated, so does the user interface. +2. When the elements on the user interface get updated, the changes are propagated back to the model. + +If you don’t want to build your own custom elements Polymer comes with a collection of pre-built elements that you can just drop on a page and use immediately. You can even use Polymer's collection of elements as a starting point for you own elements. Just include it in a project, expand upon it customizing the element to your liking, thus creating your own custom element. + + + ```html