merged attilaolah README formatting changes, update API description