updated explanation of 'pyin' messages
remove old note from the docs
Merge pull request #5008 from ivanov/messaging-doc

updated explanation of 'pyin' messages