finish readme, break out / update code examples