Create README.md

Initial draft
move return section to the bottom of the function
Merge 'master' into branch devo, new readme draft has been added
update readme