updated readme ready for the PR merge