readme improvements
mapping details
message mapping