updated readme with API and examples, removed old index comments