third_party/polymer/v1_0/README.chromium

   1 Name: Polymer
   2 Short Name: polymer
   3 URL: http://www.polymer-project.org
   4 Version: 1.0.3
   5 Revision: (See components/<component>/.bower.json)
   6 License: BSD
   7 License File: ../LICENSE.polymer
   8 Security Critical: no
   9
  10 Description:
  11 This directory contains a copy of the following components which are a part of
  12 the Polymer project:
  13 -polymer core + externs
  14 -Iron elements and their dependencies
  15 -Paper elements and their dependencies
  16 -more-routing
  17 See bower.json for a full list of components.
  18
  19 The version can be found in header of polymer/polymer.js. The license can
  20 be found in polymer/LICENSE.
  21
  22 The source git repositories can be found at:
  23 Core Library - https://github.com/Polymer/polymer
  24 Elements - https://github.com/PolymerElements/<element name>
  25
  26 Polymer is comprised of two efforts:
  27 1. A set of core platform features (Shadow DOM, Custom Elements, MDV).
  28 Initially, these core features will be enabled with a set of polyfills. As
  29 browsers begin to implement these new primitives, the polyfill platform layer
  30 becomes smaller and better over time.
  31 2. A next-generation web application framework built upon these core
  32 technologies called the Polymer.
  33
  34 Local Modifications:
  35 - Removed executable bit from the files in 'components/iron-selector'.
  36 - Created a copy 'components-chromium' of the 'components' directory with the
  37 only difference that all inline JavaScript blocks are extracted from Polymer
  38 HTML elements to external JS files. This version of the Polymer is used in a web
  39 UI, where CSP forbids an execution of inline scripts. The extraction was made
  40 using Crisper (https://github.com/PolymerLabs/crisper).
  41 - Replaced CRLF line endings with LF line endings in text files.
  42
  43 To restore the contents of the 'components' and 'components-chromium'
  44 directories from scratch, run ./reproduce.sh (requires bower and crisper).
  45
  46 Note on Bower:
  47 The directory can be updated by running "bower update". A new component can be
  48 installed by running "bower install -S Polymer/<component>#version". Be sure to
  49 add the .bower.json file to the repository as it includes the revision
  50 information of the polymer component.
  51 Also be sure that you listed all the added packages and **all their
  52 dependencies** in bower.json, and specified **exact** versions of every package
  53 explicitly. That is needed because Bower can't handle recursive dependencies
  54 correctly (see http://stackoverflow.com/q/25899532).