updating docs
fixed table
updated readme with API and examples, removed old index comments
updated reame options tables
added async description to readme
slight readme update
slight modification to readme
added examples dir, ignoring DS_Stores