Improve MessageExpectation docs.

- Group the methods.
- Specify return values.
- Remove blank lines that were rendering in
  example output.