Add documentation in Readme.md

We shall see how this renders (I'm not always a friend of the md format)