adapting the README file to github
 using md format for the documentation