fix bug with slow readable streams
add API section to README