Improve messages api-ref description
The description for the messages API was very terse. This adds some more
details to provide some description of what the API is used for.
Messages
========
-Lists all, shows, and deletes messages.
+Lists all, shows, and deletes messages. These are error messages generated by
+failed operations as a way to find out what happened when an asynchronous
+operation failed.
Delete message
