lots of documentation for the readme.md