ammended the readme to match new code
merged readme from common