write more detailed readme.  fixes #1
clarify
Merge branch 'frontend'