Update readme with proposed new api