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