finish README - first draft - fix #1

this is my first pull request - how does it look