Update readme with better intro and documentation of additional methods