* added some documentation in markdown to be displayed by github