Improve error messages and docstrings for bilby read function

Charlie Hoyrequested to merge
bilby_read_error into master

The purpose of this MR is to improve the error messages and docstrings for the bilby read function. This fixes issue #254.

Merge request reports