write more detailed readme.  fixes #1