Merge pull request #8 from katowulf/master

remove duplicate Firebase constructors (re-use references)

README.markdown

@@ -7,14 +7,18 @@ This script does two things:
 
 #### Getting started:
 
-1. Edit backbone-firebase.js to configure the URL to use your app's namespace.
-2. Include backbone-firebase.js in your project.
+1. Include backbone-firebase.js in your project.
+2. Set BackboneFirebase.DEFAULT_INSTANCE to your Firebase URL
 3. By default all models/collections will persist to Firebase based on the URL path of the model/collection.
 
-If you would like your collection to stay in sync w/ Firebase do the following:
+Example:
+
+```javascript
+    BackboneFirebase.DEFAULT_INSTANCE = 'https://YOURDB.firebaseio.com';
 
     var Post = Backbone.Model.extend({
-      idAttribute: '_firebase_name'
+      idAttribute: '_firebase_name',
+      url: '/posts'
     });
 
     var collection = Backbone.Collection.extend({
@@ -24,8 +28,64 @@ If you would like your collection to stay in sync w/ Firebase do the following:
       initialize: function() {
         this.backboneFirebase = new BackboneFirebase(this);
       }
+    });
+```
+
+#### Advanced Examples
+
+Overriding the model's default path ( model.url + '/' + model.id ) with something fancy:
+
+```javascript
+   var WackyPost = Backbone.Model.extend({
+      idAttribute: '_firebase_name',
+      url: function() {
+         return '/posts/'+(Math.random() * 100 + 1); // pick a random record because we like being wacky
+      }
+   });
+```
 
+Using multiple Firebase instances:
+
+```javascript
+    var collectionOne = Backbone.Collection.extend({
+      model: Post,
+      url: "/posts1",
+
+      initialize: function() {
+        this.backboneFirebase = new BackboneFirebase(this, {urlPrefix: 'http://DB_ONE.firebaseio.com'});
+      }
     });
 
+    var collectionTwo = Backbone.Collection.extend({
+      model: Post,
+      url: "/posts2",
+
+      initialize: function() {
+        this.backboneFirebase = new BackboneFirebase(this, {urlPrefix: 'http://DB_TWO.firebaseio.com'});
+      }
+    });
+```
+
+Using the orginal Backbone.sync (AJAX) in tandem with Firebase:
+
+```javascript
+    // Declare the sync resource to override BackboneFirebase
+    var Post = Backbone.Model.extend({
+      sync:  Backbone.sync_AJAX
+    });
+```
+
+Unbind Firebase callbacks (stop monitoring data and using resources) if a collection is no longer needed:
+
+```javascript
+   // inside Backbone.Collection
+   initialize: function() {
+      this.backboneFirebase = new new BackboneFirebase(this, {urlPrefix: 'http://DB_ONE.firebaseio.com'});
+   }
+
+   destroy: function() {
+      this.backboneFirebase.dispose();
+   }
+```
 
-Questions? Comments? Let me know!
+Questions? Comments? [Let me know](https://github.com/alexbain/backbone-firebase/issues)!