high level docs and updated sending messages diagram