better documentation in README.markdown