more docs
some docs on the new error stuff