updated docs for salmon api, BDD style object modifying, filtering, and sorting. other minor changes, updated readme. and some styles.