update readme as well. Closes #527