enhanced custom error class descriptions
added some more sanity checks