update contributing section
update doc
update readme markdown
Merge branch 'master' into gh-pages