add some documentation to the messages method
readme :heart: