more extensive documentation in the front-facing README.md