expand documentation in README