Merge pull request #138 from GoogleWebComponents/point-to-polymerfire

added pointers to new polymerfire component

Author: ebidel

README.md

@@ -1,4 +1,7 @@
-firebase-element
+## Note: This element is for the older Firebase 2.0 API.
+For the latest official Firebase 3.0-compatible component from the Firebase team,
+see the [polymerfire](https://github.com/firebase/polymerfire) component.
+
 ================
 
 See the [component page](https://elements.polymer-project.org/elements/firebase-element?active=firebase-collection) for more information.

firebase-auth.html

@@ -11,6 +11,10 @@
 <link rel="import" href="../polymer/polymer.html">
 
 <!--
+**Note: This element is for the older Firebase 2 API**
+For the latest official Firebase 3.0-compatible component from the Firebase team,
+see the [polymerfire](https://github.com/firebase/polymerfire) component.
+
 Element wrapper for the Firebase authentication API (https://www.firebase.com/docs/web/guide/user-auth.html).
 
 @demo demo/index.html

firebase-collection.html

@@ -12,6 +12,12 @@
 <link rel="import" href="firebase-query-behavior.html">
 
 <!--
+**Note: This element is for the older Firebase 2 API**
+For the latest official Firebase 3.0-compatible component from the Firebase team,
+see the [polymerfire](https://github.com/firebase/polymerfire) component.
+In this new component, the `firebase-collection` element has been replaced
+with [`firebase-query`](https://github.com/firebase/polymerfire#firebase-query)
+
 An element wrapper for the Firebase API that provides a view into the provided
 Firebase location as an ordered collection.
 
@@ -257,7 +263,7 @@ <h4>[[dinosaur.__firebaseKey__]]</h4>
 
         if (!this.query) {
           this._fireQueryError('Query does not exist');
-          return; 
+          return;
         }
 
         query = this.query.ref().push();
@@ -336,7 +342,7 @@ <h4>[[dinosaur.__firebaseKey__]]</h4>
 
         if (!this.query) {
           this._fireQueryError('Query does not exist');
-          return; 
+          return;
         }
 
         var key = change.path.split('.')[1];
@@ -399,7 +405,7 @@ <h4>[[dinosaur.__firebaseKey__]]</h4>
 
         try {
           query = new Firebase(location);
-          
+
           if (orderByMethodName) {
             if (orderByMethodName === 'orderByChild') {
               query = query[orderByMethodName](this.orderByChild);
@@ -429,13 +435,13 @@ <h4>[[dinosaur.__firebaseKey__]]</h4>
           }
 
         } catch(e) {
-          
+
           this._fireQueryError('Query cannot be instantiated with location ' + location + ' (' + e.toString() + ')');
-        
+
         } finally {
-        
+
           return query;
-        
+
         }
 
       },

firebase-document.html

@@ -13,6 +13,10 @@
 <link rel="import" href="firebase-query-behavior.html">
 
 <!--
+**Note: This element is for the older Firebase 2 API**
+For the latest official Firebase 3.0-compatible component from the Firebase team,
+see the [polymerfire](https://github.com/firebase/polymerfire) component.
+
 An element wrapper for the Firebase API.
 
 A `<firebase-document>` is a reference to a remote document somewhere on
@@ -92,11 +96,11 @@
       }
       var query;
       try {
-      
+
         query =  new Firebase(location);
-      
+
       } catch(e) {
-        
+
         this._fireQueryError('Query cannot be instantiated with location ' + location + ' (' + e.toString() + ')');
 
       } finally {
@@ -106,40 +110,40 @@
 
     _updateRemoteDocument: function() {
       this._log('Updating remote document');
-      
+
       if (!this.query) {
 
         this._fireQueryError('Query does not exist');
-        return; 
+        return;
 
       }
 
       this.query.update(this.dataAsObject);
-      
+
     },
 
     _setRemoteDocumentChild: function(key, value) {
       if (!this.query) {
 
         this._fireQueryError('Query does not exist');
-        return; 
+        return;
 
       }
 
       this.debounce('set-' + key, function() {
         this._log('Setting child "' + key + '" to', value);
         this.query.child(key).set(value);
       });
-    
+
     },
 
     _removeRemoteDocumentChild: function(key) {
       this._log('Removing child "' + key + '"');
-      
+
       if (!this.query) {
 
         this._fireQueryError('Query does not exist');
-        return; 
+        return;
 
       }
 

firebase-query-behavior.html

@@ -12,7 +12,11 @@
 <link rel="import" href="firebase.html">
 
 <script>
-  /** @polymerBehavior */
+  /** @polymerBehavior
+  **Note: This element is for the older Firebase 2 API**
+  For the latest official Firebase 3.0-compatible component from the Firebase team,
+  see the [polymerfire](https://github.com/firebase/polymerfire) component.
+  */
   Polymer.FirebaseQueryBehavior = {
     properties: {
       /**