added content to readme, cleaned API