In order to define failure, we found it useful to include yardoc's @raise

There is a name and a description, e.g. error code and a description when it appears