wrote a rather extensive readme.md