Update README.md

Author: shariq

README.md

@@ -1,38 +1,31 @@
 #firebase-python
 ######A nice (working!) Python Firebase integration for hackers
 
-Quick and dirty but not crappy: this Python module will get you from 0 to Firebase in under 3 seconds. 
-
-Supports streaming API but not authentication.
+Quick and dirty, but not crappy. Supports streaming API but not authentication.
 
 Requires `requests` and `sseclient`, which are on pip. If you don't know what that is, don't worry; just run `./setup.sh`.
 
 
 
 ##get and put
 
-`get` gets the value of a Firebase at some URL, and `put` sets the value of a Firebase at some URL to some data.
+`get` gets the value of a Firebase at some URL, and `put` sets the value of a Firebase at URL to some data.
 
 ```python
 >>> import firebase
-
 >>> URL = 'lucid-lychee'  # see note on URLs at the bottom of documentation
-
 >>> firebase.get(URL) == None  # this is an empty Firebase
 True
 
 >>> firebase.put(URL, 'tell me everything')  # can take a string
-
 >>> firebase.get(URL)
 u'tell me everything'
 
 >>> firebase.put(URL, {'lucidity': 9001})  # or a dictionary
-
 >>> firebase.get(URL)
 {u'lucidity': 9001}
 
 >>> firebase.put(URL, {'color': 'red'})  # replaces old value
-
 >>> firebase.get(URL)
 {u'color': u'red'}
 
@@ -44,23 +37,19 @@ u'red'
 
 ##patch
 
-`patch` updates an existing key value store at some URL with new key value pairs, without deleting the old key value pairs.
+`patch` adds new key value pairs to an existing Firebase, without deleting the old key value pairs.
 
 ```python
 >>> import firebase
-
 >>> URL = 'tibetan-tumbleweed'
-
 >>> firebase.get(URL) == None
 True
 
 >>> firebase.patch(URL, {'taste': 'tibetan'})
-
 >>> firebase.get(URL)
 {u'taste': u'tibetan'}
 
 >>> firebase.patch(URL, {'size': 'tumbly})  # patching does not overwrite
-
 >>> firebase.get(URL)
 {u'taste': u'tibetan', u'size': u'tumbly'}
 ```
@@ -69,35 +58,28 @@ True
 
 ##subscriber
 
-`subscriber` takes a URL and callback function and calls that callback on every update of the Firebase at URL.
+`subscriber` takes a URL and callback function and calls the callback on every update of the Firebase at URL.
 
 ```python
 >>> import firebase
-
 >>> from pprint import pprint  # function which pretty prints objects
-
 >>> URL = 'clumsy-clementine'
-
 >>> S = firebase.subscriber(URL, pprint)  # pprint will be called on all Firebase updates
-
 >>> S.start()  # will get called with initial value of URL, which is empty
 {u'data': None, u'path': u'/'}
 
 >>> firebase.put(URL, ';-)')  # will make S print something
 {u'data': u';-)', u'path': u'/'}
 
->>> firebase.put(URL, {'status': 'mortified'})
+>>> firebase.put(URL, {'status': 'mortified'})  # continuing from above
 {u'data': {u'status': u'mortified'}, u'path': u'/'}
-
 >>> firebase.patch(URL, {'reason': 'blushing'})  # this one is scary
 {u'data': {u'reason': u'blushing'}, u'path': u'/'}
-
->>> firebase.get(URL)  # notice the update only gave us the update without telling us
+>>> firebase.get(URL)  # notice the update only gave us the new k,v without telling us
 {u'status': u'mortified', u'reason': u'blushing'}
 
 >>> firebase.put(URL, {'color': 'orange-red'})  # expect change from S
 {u'data': {u'color': u'orange-red'}, u'path': u'/'}
-
 >>> firebase.get(URL)  # put overwrites, but S doesn't tell us!
 {u'color': u'orange-red'}