Updated documentation
Added missing links in README markdown
merged upstream/master