src/third_party/polymer/README.chromium

   1 Name: Polymer
   2 Short Name: polymer
   3 URL: http://www.polymer-project.org
   4 Version: 0.3.5
   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
  14 -platform
  15 -all core elements and their dependencies (except "core-animation{,-group}")
  16 -all paper elements and their dependencies (except "paper-menu-button")
  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 https://github.com/Polymer/<component>
  24
  25 Polymer is comprised of two efforts:
  26 1. A set of core platform features (Shadow DOM, Custom Elements, MDV).
  27 Initially, these core features will be enabled with a set of polyfills. As
  28 browsers begin to implement these new primitives, the polyfill platform layer
  29 becomes smaller and better over time.
  30 2. A next-generation web application framework built upon these core
  31 technologies called the Polymer.
  32
  33 Local Modifications:
  34 - Removed executable bit from the files in 'components/core-list'.
  35 - Created a copy 'components-chromium' of the 'components' directory with the
  36 only difference that all inline JavaScript blocks are extracted from Polymer
  37 HTML elements to external JS files. This version of the Polymer is used in a web
  38 UI, where CSP forbids an execution of inline scripts. The extraction was made
  39 with the help of the Vulcanize tool (https://github.com/Polymer/vulcanize).
  40
  41 To restore a content of the 'components', 'components-chromium' directorires
  42 from scratch, run ./reproduce.sh (requires bower and vulcanize).
  43
  44 Note on Bower:
  45 The directory can be updated by running "bower update". A new component can be
  46 installed by running "bower install -S Polymer/<component>#version". Be sure to
  47 add the .bower.json file to the repository as it includes the revision
  48 information of the polymer component.
  49 Also be sure that you listed all the added packages and **all their
  50 dependencies** in bower.json, and specified **exact** versions of every package
  51 explicitly. That is needed because Bower can't handle recursive dependencies
  52 correctly (see http://stackoverflow.com/q/25899532).