Improve docs to explain hardware message -> software message translation